Dieser Abschnitt enthält Beispiele für Anfragen und Antworten für gängige Avails-API-Operationen. Jedes Beispiel zeigt die richtige JSON-Struktur und die erforderlichen Felder, sodass Sie Ihre Integration mit Prime Video erstellen und testen können. Verwenden Sie diese Beispiele als Vorlagen, wenn Sie Ihre Avails einreichen und aktualisieren. Sie können sie direkt in Ihre Konsole kopieren, um Ihre Implementierung zu überprüfen, bevor Sie Inhalte an Prime Video bereitstellen.
Avails-API-Nutzdatenbeispiele erstellen/aktualisieren
Mit der Avails-API können Sie Verfügbarkeitsfenster für Ihre Inhalte im Prime Video-System erstellen und aktualisieren. Dieser Abschnitt enthält Beispiele für Anfragen und Antworten und zeigt, wie Sie Ihre API-Aufrufe für verschiedene Szenarien strukturieren können.
Beispiel 1: Kanalfolge mit mehreren Avails
Anfrage 1: Verfügbarkeit auf Episodenebene mit 2 Fenstern — Mit dieser Anfrage wird die Verfügbarkeit einer Episode auf einem Abonnementkanal mit den beiden Videoformaten UHD und HD hergestellt:
{
"avail": {
"SharedEntitlement": [
{
"_ecosystem": "DMA",
"EcosystemID": "DemoDMA_Title_ID"
}
],
"ALID": "demoALID",
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "demoALID",
"WorkType": "Episode",
"EpisodeMetadata": {
"TitleInternalAlias": [
"Avail Strikes Back: Season 1, Episode 2"
],
"EpisodeNumber": {
"Number": 2
},
"SeasonMetadata": {
"SeasonContentID": "demoALID_For_Season_01",
"SeasonTitleInternalAlias": [
"Avail Strikes Back: Season 1"
],
"SeasonNumber": {
"Number": 1
},
"NumberOfEpisodes": 77
},
"SeriesMetadata": {
"SeriesContentID": "demoALID_For_Series",
"SeriesTitleInternalAlias": [
"Avail Strikes Back"
],
"NumberOfSeasons": 4
}
}
}
],
"Transaction": [
{
"_TransactionID": "availId123",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"ContractID": "CPH",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "mgm_plus_subscription"
},
{
"_termName": "adKey",
"Text": "Break776353"
},
{
"_termName": "Category",
"Text": "sub"
},
{
"_termName": "Download",
"Text": "Yes"
},
{
"_termName": "RentalDuration",
"Duration": "PT720H"
},
{
"_termName": "WatchDuration",
"Duration": "PT48H"
},
{
"_termName": "Exclusive",
"Boolean": true
},
{
"_termName": "ExclusiveAttributes",
"Text": "SECOND_RUN_EXCLUSIVE"
}
]
},
{
"_TransactionID": "availId456",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"ContractID": "CPH",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "mgm_plus_subscription"
},
{
"_termName": "Category",
"Text": "sub"
},
{
"_termName": "Download",
"Text": "Yes"
},
{
"_termName": "RentalDuration",
"Duration": "PT720H"
},
{
"_termName": "WatchDuration",
"Duration": "PT48H"
},
{
"_termName": "Exclusive",
"Boolean": false
}
]
}
]
}
}
Anfrage 2: Verfügbarkeit auf Saisonebene für ein einzelnes Videofenster
Mit dieser Anfrage wird die Verfügbarkeit für die gesamte Staffel 1 auf einem anderen Abonnementkanal im SD-Format gewährleistet:
{
"avail": {
"ALID": "demoALID_For_Season_01",
"SharedEntitlement": [
{
"_ecosystem": "DMA",
"EcosystemID": "DemoDMA_Title_ID"
}
],
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "demoALID_For_Season_01",
"WorkType": "Season",
"SeasonMetadata": {
"SeasonContentID": "demoALID_For_Season_01",
"SeasonTitleInternalAlias": [
"Avail Strikes Back: Season 1"
],
"SeasonNumber": {
"Number": 1
},
"NumberOfEpisodes": 77,
"SeriesMetadata": {
"SeriesContentID": "demoALID_For_Series",
"SeriesTitleInternalAlias": [
"Avail Strikes Back"
],
"NumberOfSeasons": 4
}
}
}
],
"Transaction": [
{
"_TransactionID": "availId789season",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"ContractID": "CPH",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "A4K"
},
{
"_termName": "Category",
"Text": "sub"
},
{
"_termName": "Download",
"Text": "Yes"
},
{
"_termName": "RentalDuration",
"Duration": "PT720H"
},
{
"_termName": "WatchDuration",
"Duration": "PT48H"
},
{
"_termName": "Exclusive",
"Boolean": false
}
]
}
]
}
}
Beispiel 2: FVOD-Film mit mehreren Locales
{
"avail": {
"ALID": "demoALID",
"SharedEntitlement": [
{
"_ecosystem": "DMA",
"EcosystemID": "DemoDMA_Title_ID"
}
],
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "demoALID",
"WorkType": "Movie",
"Metadata": {
"TitleInternalAlias": [
"Harry Potter and Marge Simpson"
]
}
}
],
"Transaction": [
{
"_TransactionID": "availId123movie",
"LicenseType": "FVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "FVOD"
},
{
"_termName": "Category",
"Text": "sub"
},
{
"_termName": "Download",
"Text": "No"
},
{
"_termName": "Exclusive",
"Boolean": true
},
{
"_termName": "ExclusiveAttributes",
"Text": "SECOND_RUN_EXCLUSIVE"
}
]
},
{
"_TransactionID": "availId456movie",
"LicenseType": "FVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "FVOD"
},
{
"_termName": "Category",
"Text": "sub"
},
{
"_termName": "Download",
"Text": "No"
},
{
"_termName": "Exclusive",
"Boolean": false
}
]
}
]
}
}
Beispiel 3: TVOD-Film
{
"avail": {
"ALID": "demoALID",
"SharedEntitlement": [
{
"_ecosystem": "DMA",
"EcosystemID": "DemoDMA_Title_ID"
}
],
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "demoALID",
"WorkType": "Movie",
"Metadata": {
"TitleInternalAlias": [
"Harry Potter and Marge Simpson"
]
}
}
],
"Transaction": [
{
"_TransactionID": "availId123movie",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "SRP",
"Money": {
"value": 8.99,
"_currency": "USD"
}
},
{
"_termName": "WSP",
"Money": {
"value": 7.99,
"_currency": "USD"
}
},
{
"_termName": "RentalDuration",
"Duration": "PT720H"
},
{
"_termName": "WatchDuration",
"Duration": "PT48H"
},
{
"_termName": "Download",
"Text": "No"
},
{
"_termName": "Exclusive",
"Boolean": true
},
{
"_termName": "ExclusiveAttributes",
"Text": "SECOND_RUN_EXCLUSIVE"
}
]
},
{
"_TransactionID": "availId456movie",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "SRP",
"Money": {
"value": 19.99,
"_currency": "USD"
}
},
{
"_termName": "WSP",
"Money": {
"value": 18.99,
"_currency": "USD"
}
},
{
"_termName": "Download",
"Text": "Yes"
},
{
"_termName": "Exclusive",
"Boolean": false
},
{
"_termName": "AnnounceDate",
"Event": "2022-05-22T10:00:00Z"
}
]
},
{
"_TransactionID": "availId789movie",
"LicenseType": "POEST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2023-03-14T09:00:00Z",
"End": "2029-05-22T10:00:00Z",
"LicenseRightsDescription": "DAB",
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"HoldbackLanguage": [
{
"value": "fr-CA",
"_asset": "subtitle"
},
{
"value": "fr-CA",
"_asset": "audio"
}
],
"Terms": [
{
"_termName": "SRP",
"Money": {
"value": 18.99,
"_currency": "USD"
}
},
{
"_termName": "WSP",
"Money": {
"value": 17.99,
"_currency": "USD"
}
},
{
"_termName": "Download",
"Text": "Yes"
},
{
"_termName": "Exclusive",
"Boolean": false
},
{
"_termName": "AnnounceDate",
"Event": "2022-05-22T10:00:00Z"
},
{
"_termName": "SuppressionLiftDate",
"Event": "2022-07-24T10:00:00Z"
}
]
}
]
}
}
Beispiel 4: Filmtrailer
{
"avail": {
"ALID": "demoALID",
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "demoALID",
"WorkType": "Supplemental",
"Metadata": {
"TitleInternalAlias": [
"Movie: Trailer"
]
}
}
],
"Transaction": [
{
"_TransactionID": "availId123movietrailer",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2024-12-09T14:00:00Z",
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "FVOD"
}
]
},
{
"_TransactionID": "availId123movietrailer",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2024-12-09T14:00:00Z",
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "FVOD"
}
]
}
]
}
Beispiel 5: Trailer zur TV-Serie
{
"avail": {
"ALID": "demoALID",
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "demoALID",
"WorkType": "Supplemental",
"Metadata": {
"TitleInternalAlias": [
"Title Name - Season 3: Official Final Trailer"
]
}
}
],
"Transaction": [
{
"_TransactionID": "availId123tvtrailer",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2025-09-05T13:00:00Z",
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "FVOD"
}
]
},
{
"_TransactionID": "availId123tvtrailer",
"LicenseType": "SVOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2025-09-05T13:00:00Z",
"Terms": [
{
"_termName": "ChannelIdentity",
"Text": "FVOD"
}
]
}
]
}
}
Beispiel 6: Filmpaket mit Rabatt
{
"avail": {
"ALID": "TEST_COLLECTION",
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "mgm"
},
"Asset": [
{
"_contentID": "TEST_COLLECTION",
"WorkType": "Collection",
"Metadata": {
"TitleInternalAlias": [
"TEST COLLECTION (4)"
]
},
"BundleAsset": [
{
"BundledALID": "Bundle_Movie_1"
},
{
"BundledALID": "Bundle_Movie_2"
},
{
"BundledALID": "Bundle_Movie_3"
},
{
"BundledALID": "Bundle_Movie_4"
}
]
}
],
"Transaction": [
{
"_TransactionID": "Bundle_collection_est",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "Max"
},
"Start": "2025-10-18T04:00:00Z",
"End": "2032-11-22T04:59:59.999Z",
"Terms": [
{
"_termName": "Tier",
"Text": "CAT EST",
"Money": {
"_currency": "USD"
}
},
{
"_termName": "SRP",
"Money": {
"value": 44.99,
"_currency": "USD"
}
},
{
"_termName": "CompleteYourBundleDiscountPercentage",
"Number": 20
}
]
}
]
}
}
Beispiel 7: TV-Serien-Bundle
{
"avail": {
"ALID": "Test_TV_Bundle_1",
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "TestLicensor"
},
"Asset": [
{
"_contentID": "Test_TV_Bundle_1",
"WorkType": "Series",
"SeriesMetadata": {
"SeriesTitleInternalAlias": [
"TV_Bundle_Test"
],
"NumberOfSeasons": 2
}
}
],
"Transaction": [
{
"_TransactionID": "tv_bundle_series_est",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "Max"
},
"Start": "2025-08-26T04:00:00Z",
"End": "2100-01-01T04:59:59.999Z",
"AssetLanguage": [
{
"value": "EN"
}
],
"Terms": [
{
"_termName": "SRP",
"Money": {
"value": 44.99,
"_currency": "USD"
}
},
{
"_termName": "WSP",
"Money": {
"value": 28.34,
"_currency": "USD"
}
},
{
"_termName": "CompleteYourBundleDiscountPercentage",
"Number": 50
}
]
}
]
}
}
Beispiel 8: Film exkl. Rabatt aus Bundles
{
"avail": {
"ALID": "SKU12345",
"Disposition": {
"EntryType": "FullExtract"
},
"Licensor": {
"DisplayName": "TestLicensor"
},
"SharedEntitlement": [
{
"_ecosystem": "DMA",
"EcosystemID": "Test1234567"
}
],
"Asset": [
{
"_contentID": "SKU12345",
"WorkType": "Movie",
"Metadata": {
"TitleInternalAlias": [
"Exclude_from_Bundles_Test"
]
}
}
],
"Transaction": [
{
"_TransactionID": "exclude_bundle_uhd_premium",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2025-11-25T05:00:00Z",
"End": "2026-04-07T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 12.99,
"_currency": "USD"
}
},
{
"_termName": "ExcludedFromBundleDiscount",
"Boolean": true
}
]
},
{
"_TransactionID": "exclude_bundle_hd_premium",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2025-11-25T05:00:00Z",
"End": "2026-04-07T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 12.99,
"_currency": "USD"
}
},
{
"_termName": "ExcludedFromBundleDiscount",
"Boolean": true
}
]
},
{
"_TransactionID": "exclude_bundle_sd_premium",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2025-11-25T05:00:00Z",
"End": "2026-04-07T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 12.99,
"_currency": "USD"
}
},
{
"_termName": "ExcludedFromBundleDiscount",
"Boolean": true
}
]
},
{
"_TransactionID": "exclude_bundle_uhd_midtier",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2026-04-07T04:00:00Z",
"End": "2027-04-07T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 10.99,
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_hd_midtier",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2026-04-07T04:00:00Z",
"End": "2027-04-07T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 10.99,
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_sd_midtier",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2026-04-07T04:00:00Z",
"End": "2027-04-07T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 10.99,
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_uhd_catalog",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2027-04-07T04:00:00Z",
"End": "2031-01-01T04:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 11.99,
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_hd_catalog",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2027-04-07T04:00:00Z",
"End": "2031-01-01T04:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 11.99,
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_sd_catalog",
"LicenseType": "EST",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2027-04-07T04:00:00Z",
"End": "2031-01-01T04:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "WSP",
"Money": {
"value": 11.99,
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_uhd_vod_premium",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2025-10-28T04:00:00Z",
"End": "2026-04-27T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "Category",
"Text": "NR",
"Money": {
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_hd_vod_premium",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2025-10-28T04:00:00Z",
"End": "2026-04-27T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "Category",
"Text": "NR",
"Money": {
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_sd_vod_premium",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2025-10-28T04:00:00Z",
"End": "2026-04-27T03:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "Category",
"Text": "NR",
"Money": {
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_uhd_vod_catalog",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "UHD"
},
"Start": "2026-04-27T04:00:00Z",
"End": "2031-01-01T04:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "Category",
"Text": "LB",
"Money": {
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_hd_vod_catalog",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "HD"
},
"Start": "2026-04-27T04:00:00Z",
"End": "2031-01-01T04:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "Category",
"Text": "LB",
"Money": {
"_currency": "USD"
}
}
]
},
{
"_TransactionID": "exclude_bundle_sd_vod_catalog",
"LicenseType": "VOD",
"Territory": [
{
"country": "US"
}
],
"FormatProfile": {
"value": "SD"
},
"Start": "2026-04-27T04:00:00Z",
"End": "2031-01-01T04:59:59Z",
"AssetLanguage": [
{
"value": "en"
}
],
"AllowedLanguage": [
{
"_asset": "audio",
"value": "en"
},
{
"_asset": "subtitle",
"value": "en"
}
],
"Terms": [
{
"_termName": "Category",
"Text": "LB",
"Money": {
"_currency": "USD"
}
}
]
}
]
}
}
Avails-API-Beispiele abrufen
Dieser Abschnitt enthält Beispiele für Anfragen und Antworten und zeigt, wie Sie Ihre API-Aufrufe strukturieren können, um auf vorhandene Informationen zu Inhaltsrechten zuzugreifen.
Beispiel 1: Verfügbarkeit von Titeln abrufen
REQUEST
Method: GET
Url: https://partnerapi.primevideo.com/v1/avails/testlicensor/full-extract/demoAlid?territory=US&businessLine=PRIME_SUBSCRIPTION
RESPONSE
StatusCode: 200
Body:
{
"avail": {
"ALID": "demoAlid",
"Asset": [
{
"EpisodeMetadata": {
"EpisodeNumber": {
"Number": 2
},
"SeasonMetadata": {
"NumberOfEpisodes": 77,
"SeasonContentID": "demoALID_For_Season_01",
"SeasonNumber": {
"Number": 1
},
"SeasonTitleInternalAlias": [
"AvailStrikesBack:Season1"
]
},
"SeriesMetadata": {
"NumberOfSeasons": 4,
"SeriesContentID": "demoALID_For_Series",
"SeriesTitleInternalAlias": [
"AvailStrikesBack"
]
},
"TitleInternalAlias": [
"TestTitleName"
]
},
"WorkType": "Episode",
"_contentID": "demoAlid"
}
],
"Licensor": {
"DisplayName": "testlicensor"
},
"Transaction": [
{
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"ContractID": "CPH",
"End": "2029-05-22T10:00:00Z",
"FormatProfile": {
"value": "UHD"
},
"HoldbackLanguage": [
{
"_asset": "subtitle",
"value": "fr-CA"
},
{
"_asset": "audio",
"value": "fr-CA"
}
],
"LicenseRightsDescription": "DAB",
"LicenseType": "SVOD",
"Start": "2023-03-14T09:00:00Z",
"Terms": [
{
"Text": "prime",
"_termName": "ChannelIdentity"
},
{
"Text": "Yes",
"_termName": "Download"
},
{
"Duration": "PT720H",
"_termName": "RentalDuration"
},
{
"Duration": "PT48H",
"_termName": "WatchDuration"
},
{
"Money": {
"_currency": "USD",
"value": 15.99
},
"_termName": "SRP"
},
{
"Boolean": true,
"_termName": "Exclusive"
},
{
"_termName": "ExclusiveAttributes"
}
],
"Territory": [
{
"country": "US"
}
]
}
]
},
"success": true
}
Validate Avails API-Beispiele
Mit der Avails-API können Sie Ihre Verfügbarkeitsfenster auf Fehler testen, bevor Sie sie an die Live-Systeme von Prime Video senden. Dieser Abschnitt enthält Beispiele für Anfragen und Antworten und zeigt, wie Sie Ihre API-Aufrufe strukturieren können, um Fehler frühzeitig in Ihrem Integrationsworkflow zu erkennen.
Beispiel 1: Überprüfen Sie die vollständige Datenverfügbarkeit
REQUEST
Method: POST
Url: https://partnerapi.primevideo.com/v1/avails/testlicensor/full-extract/demoAlid/validate
Body:
{
"avail": {
"ALID": "demoAlid",
"Asset": [
{
"EpisodeMetadata": {
"EpisodeNumber": {
"Number": 2
},
"SeasonMetadata": {
"NumberOfEpisodes": 77,
"SeasonContentID": "demoALID_For_Season_01",
"SeasonNumber": {
"Number": 1
},
"SeasonTitleInternalAlias": [
"AvailStrikesBack:Season1"
]
},
"SeriesMetadata": {
"NumberOfSeasons": 4,
"SeriesContentID": "demoALID_For_Series",
"SeriesTitleInternalAlias": [
"AvailStrikesBack"
]
},
"TitleInternalAlias": [
"TestTitleName"
]
},
"WorkType": "Episode",
"_contentID": "demoAlid"
}
],
"Licensor": {
"DisplayName": "testlicensor"
},
"Transaction": [
{
"AssetLanguage": [
{
"value": "en-US"
},
{
"value": "fr-FR"
},
{
"value": "fr-CA"
}
],
"ContractID": "CPH",
"End": "2029-05-22T10:00:00Z",
"FormatProfile": {
"value": "UHD"
},
"HoldbackLanguage": [
{
"_asset": "subtitle",
"value": "fr-CA"
},
{
"_asset": "audio",
"value": "fr-CA"
}
],
"LicenseRightsDescription": "DAB",
"LicenseType": "SVOD",
"Start": "2023-03-14T09:00:00Z",
"Terms": [
{
"Text": "prime",
"_termName": "ChannelIdentity"
},
{
"Text": "Yes",
"_termName": "Download"
},
{
"Duration": "PT720H",
"_termName": "RentalDuration"
},
{
"Duration": "PT48H",
"_termName": "WatchDuration"
},
{
"Money": {
"_currency": "USD",
"value": 15.99
},
"_termName": "SRP"
},
{
"Boolean": true,
"_termName": "Exclusive"
},
{
"_termName": "ExclusiveAttributes"
}
],
"Territory": [
{
"country": "US"
}
]
}
]
}
}
RESPONSE
StatusCode: 200
Body:
{
"success": true,
"validationErrors": []
}
Avails-API-Beispiele löschen
Hinweis: Wir empfehlen dringend, Inhalte ablaufen zu lassen, indem das Enddatum angepasst wird, anstatt sie zu löschen, es sei denn, es handelt sich um einmalige Anwendungsfälle. Beim Ablaufen bleiben Ihre historischen Daten und Ihr Prüfprotokoll erhalten.
Beispiel 1: Alle Verfügbarkeit für einen Titel entfernen
REQUEST
Method: Delete
Url: https://partnerapi.primevideo.com/v1/avails/testlicensor/full-extract/demoAlid?territory=US&businessLine=PRIME_SUBSCRIPTION&contractId=CPH
RESPONSE:
{
"success": true
}
Hilfreiche Referenzen
Sie können ganz einfach unsere Prime Video-APIs nutzen. Detaillierte Informationen zum Onboarding der einzelnen API-Suiten finden Sie im Onboarding-Leitfaden. Bitte beachten Sie, dass der Onboarding-Prozess für die Content API Suite und die Analytics API Suite getrennt ist.