Die Prime Video Avails-API ist Teil der Content API-Suite und ermöglicht es Ihnen, die Verfügbarkeit Ihrer Titel auf Prime Video durch direkte Integration mit Ihren Content-Rights-Management-Systemen zu verwalten. Verfügbarkeitsfenster für das Einreichen, Aktualisieren, Abrufen oder Löschen sind präziser und kontrollierter als herkömmliche Datei-Uploads.
Warum sollten Sie die Avails-API verwenden?
Die API optimiert Ihren Content-Management-Workflow und gibt Ihnen mehr Kontrolle über Ihren Prime Video-Katalog:
- Automatisierte Verwaltung — Eliminieren Sie manuelle Uploads und reduzieren Sie Fehler, indem Sie die Einreichung und Aktualisierung des Verfügbarkeitsfensters automatisieren, sodass sich Ihr Team auf strategische Aufgaben konzentrieren kann
- Höhere Effizienz — Aktualisieren Sie bestimmte Verfügbarkeitsfenster, ohne ganze Datensätze erneut einreichen zu müssen. Das spart Zeit und reduziert redundante Verarbeitung.
- Direktes Feedback — Validieren Sie Ihre Daten in Echtzeit und erhalten Sie sofortige Fehlermeldungen, ohne sich für manuelle Korrekturen bei Slate anmelden zu müssen.
- Interoperabilität — Basiert auf einer REST-Schnittstelle, die sprach-, system- und plattformunabhängig ist und von jedem System mit Internetverbindung aus zugänglich ist.
API-Operationen und Endpunkte
Alle Endpunkte sind sprachunabhängig und über HTTP 1.1 von jedem System mit Internetverbindung aus zugänglich. Die Avails-Endpunkte folgen keinem bestimmten Protokoll und können je nach Ihren Workflow-Anforderungen in beliebiger Reihenfolge aufgerufen werden.
Über Extraktmodelle
Ein Extraktmodell definiert, wie Sie Verfügbarkeitsdaten strukturieren und an Prime Video übermitteln. Stellen Sie sich das so vor, als würden Sie wählen, ob Sie uns Ihre vollständigen Kataloginformationen senden oder nur die spezifischen Änderungen senden möchten, die Sie vornehmen müssen.
Vorgang 1 — Erstellen/Aktualisieren Avails
- Funktionsweise: Fügt neue Verfügbarkeitsfenster für Ihre Titel hinzu oder aktualisiert bestehende.
- Warum Sie es benötigen: So teilen Sie Prime Video mit, wann und wo Ihre Inhalte für Kunden verfügbar sein sollen. Ganz gleich, ob Sie neue Inhalte veröffentlichen oder eine bestehende Lizenz verlängern, dieser Vorgang stellt sicher, dass Ihre Verfügbarkeitsdaten aktuell sind.
Operation 2 — Avails abrufen
- Funktionsweise: Ruft aktuelle Verfügbarkeitsinformationen von den Systemen von Prime Video ab.
- Warum Sie es benötigen: Überprüfen Sie, welche Verfügbarkeitsdaten Prime Video gespeichert hat, beheben Sie Unstimmigkeiten oder rufen Sie Daten für Berichts- und Abstimmungszwecke ab.
Operation 3 — Validieren Avails
- Was es tut: Überprüft Ihre Verfügbarkeitsdaten auf Fehler, bevor Sie sie an die Live-Systeme von Prime Video senden.
- Warum Sie es brauchen: Erkennen Sie Formatierungsfehler, fehlende Pflichtfelder oder Verstöße gegen Geschäftsregeln, bevor sie sich auf die Verfügbarkeit Ihrer Inhalte auswirken. Das spart Zeit, da Sie nicht erst das Senden, Warten auf die Bearbeitung, das anschließende Korrigieren von Fehlern und das erneute Absenden benötigen.
Operation 4 — Avails löschen
- Was es macht: Entfernt Verfügbarkeitsfenster aus den Systemen von Prime Video.
- Warum Sie es brauchen: Behandeln Sie einmalige Szenarien, in denen die Verfügbarkeit vollständig entfernt werden muss und nicht abgelaufen ist.
- Wichtig: 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.
HTTP-Antwortcodes
Alle Avails-Endpunkte geben Standard-HTTP-Codes zurück, die Ihnen mitteilen, ob Ihre API-Anfrage erfolgreich war oder fehlgeschlagen ist und ob Fehler vorübergehend (wiederholbar) oder dauerhaft sind, sodass Ihr System Antworten ohne manuelles Eingreifen automatisch verarbeiten kann.
HTTP-Kode |
Description |
Erneut versuchbar |
200 |
Der API-Aufruf war erfolgreich. Aufrufer sollten das Antwortobjekt auf weitere Details überprüfen. |
N/A |
400 |
Fehlerhafte Anfrage, einschließlich Validierungsfehlern. |
Nein |
401 |
Nicht autorisiert. |
Nein |
404 |
Nicht gefunden. |
Nein |
500 |
Interner Fehler. |
Ja |
503 |
Abhängigkeitsfehler. |
Ja |
Hinweis: Implementieren Sie bei wiederholten Fehlern (500, 503) die Wiederholungslogik mit entsprechenden Verzögerungen zwischen den Versuchen. Fehler, die nicht wiederholt werden können (400, 401, 404), weisen auf Probleme mit Ihrer Anfrage hin, die vor dem erneuten Absenden korrigiert werden müssen.
API-Schemas
Die in dieser Dokumentation beschriebenen Schemas sollen Entwicklern bei der Integration in die Avails-API helfen. Alle Payload-Schemas entsprechen dem MDDF API v2.6-Standard. Sie können zwar alle MDDF API v2.6-Attribute in Ihre Payload aufnehmen, Prime Video verarbeitet jedoch nur unterstützte Attribute — nicht unterstützte Attribute werden ignoriert.
Hinweis: Eine vollständige Referenz der unterstützten Attribute, die unserer EMA-Verfügbarkeitsspezifikation entsprechen, finden Sie in der Spalte „EMA Avails“ in der Tabelle mit den wichtigsten Datentypen unten. Informationen darüber, wie Verfügungen in Prime Video verwaltet und verwendet werden, finden Sie auf der Seite mit den Inhaltsrechten.
MDDF-XML in JSON konvertieren
Die MDDF Avails-API definiert ihr Schema im XML-Format, unterstützt jedoch Payloads sowohl in XML als auch in JSON. Prime Video Avails-APIs verwenden JSON-kodierte Nutzlasten.Der Prozess zur Konvertierung von MDDF-XML in JSON wird im Folgenden beschrieben: Namespaces werden weggelassen
<alice>bob</alice>
becomes
{ "alice": "bob" }
Verschachtelte Elemente werden zu verschachtelten Eigenschaften
<alice><bob>charlie</bob><david>edgar</david></alice>
becomes
{ "alice": { "bob": "charlie", "david": "edgar" } }
Mehrere Elemente mit demselben Namen werden zu Array-Elementen
<alice><bob>charlie</bob><bob>david</bob></alice>
becomes
{ "alice": { "bob": [ "charlie", "david" ] } }
Attribute gehören zu den Eigenschaften und werden mit einem Unterstrich vorangestellt
<alice charlie="david">bob</alice>
becomes
{ "alice": { "_charlie": "david", "value": "bob" } }
Allgemeine Schemadatentypen
Das Avails-API-Schema unterstützt die folgenden Datentypen:
| Type |
Description |
| Boolescher Wert |
Boolescher type. Zulässige Werte: true, false |
| Ganzzahl |
32-Bit-Ganzzahl mit Vorzeichen. |
| Lange Ganzzahl |
64-Bit-Ganzzahl mit Vorzeichen. |
| Dezimal |
Fließkommazahl. |
| Zeichenfolge |
Eine Reihe von Zeichen. |
| Zeitstempel |
ISO-Zeitstempel. |
| Aufzählung |
Eine aufgezählte Zeichenfolge mit einem vordefinierten Satz zulässiger Werte. |
| Struktur |
Structure dient als Aggregator für andere Attribute. |
| Array |
Sammlung von Artikeln vom type ASME. Benannt von []. |
Hinweis: Die maximale Anzahl von Elementen, die in Batch-Anfragen zulässig sind, ist auf 100 begrenzt.
Anfrage- und Antwortschemas
In diesem Abschnitt werden die Datenstrukturen für alle Avails-API-Operationen definiert. Diese Schemas spezifizieren das genaue Format für Anfragen, die Sie an Prime Video senden, und für Antworten, die Sie zurückerhalten. Das Verständnis dieser Strukturen ist für eine erfolgreiche API-Integration unerlässlich.
Schema 1 — Erstellen/Aktualisieren Avails
Diese Schemas definieren die Struktur für die Erstellung oder Aktualisierung von Verfügbarkeitsfenstern im Prime Video-System. Verwenden Sie diese, wenn Sie neue Inhaltsrechte einreichen oder bestehende ändern müssen.
PutAvailsAPIRequest-Typ
Dies ist das primäre Anforderungsobjekt für das Senden eines einzelnen Verfügbarkeitsfensters.
Attribut |
Type |
Ist verpflichtend |
Description |
verfügbar |
Nutzen |
Ja |
Verfügbarkeitsdaten — Dies ist das oberste Attribut jeder Put- oder Validate-Anfrage |
PutAvailsAPIResponse-Typ
Die Antwort
, die Sie nach dem Absenden eines Verfügbarkeitsfensters erhalten. Überprüfen Sie das Erfolgsfeld, um zu bestätigen, dass der Vorgang abgeschlossen wurde, und überprüfen Sie die Fehler, falls die Übermittlung fehlgeschlagen ist.Attribut |
Type |
Ist verpflichtend |
Description |
Erfolg |
Boolescher Wert |
Ja |
Status der Operation |
Fehler |
Fehler [] |
Nein |
Liste der Fehler im Fehlerfall |
PutAvailsBatchAPIRequest-Typ
Verwenden Sie dieses Schema, wenn Sie mehrere Verfügbarkeitsfenster in einem einzigen API-Aufruf einreichen müssen. Batch-Operationen verbessern die Effizienz bei der Verwaltung großer Kataloge oder bei der Durchführung von Massenaktualisierungen.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel anfordern |
putAvailsBatchApiRequestItem [] |
Ja |
Liste der individuellen Anfragen |
PutAvailsBatchApiResponse-Typ
Die Batch-Antwort gibt individuelle Ergebnisse für jedes Element in Ihrer Batch-Anfrage zurück. Jedes Antwortelement entspricht einem Anforderungselement über die RequestItemID.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel der Antwort |
PutAvailsBatchAPIResponseItem [] |
Ja |
Liste der Antwortpunkte |
PutAvailsBatchApiRequestItem-Typ
Jedes Element in einer Batch-Anfrage benötigt einen eindeutigen Bezeichner und Pfad, der den Vorgangstyp (Full Extract) und die Zielressource angibt.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel-ID anfordern |
Zeichenfolge |
Ja |
Eindeutige Kennung des Artikels in der Batch-Anfrage. Dies ist eine eindeutige Zeichenfolge, anhand derer Sie jeden Artikel in der Charge identifizieren und die mit der Batch-Antwort von uns verknüpft wird. |
Pfad |
Zeichenfolge |
Ja |
Pfad zu einer Ressource für dieses Anforderungselement. |
Körper |
putAvailsBatchApiRequestItemBody |
Ja |
Daten zur Verfügbarkeit |
PutAvailsBatchApiRequestItemBody-Typ
Der Hauptteil jedes Batch-Anforderungselements enthält die tatsächlichen Verfügbarkeitsdaten, die Sie einreichen.
Attribut |
Type |
Ist verpflichtend |
Description |
verfügbar |
Nutzen |
Ja |
Daten zur Verfügbarkeit |
PutAvailsBatchApiResponseItem-Typ
Jedes Antwortelement im Batch gibt an, ob die entsprechende Anforderung erfolgreich war oder nicht. Verwenden Sie die RequestItemID, um Antworten Ihren ursprünglichen Anfragen zuzuordnen.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel-ID anfordern |
Zeichenfolge |
Ja |
Eindeutige Kennung des Artikels in der Batch-Anfrage |
Erfolg |
Boolescher Wert |
Ja |
Status der Operation |
Fehler |
Fehler [] |
Nein |
Liste der Fehler im Fehlerfall |
Schema 2 — Avails abrufen
Diese Schemas definieren, wie bestehende Verfügbarkeitsfenster aus dem Prime Video-System abgerufen werden. Verwenden Sie diese, um aktuelle Rechteinformationen für Ihre Inhalte abzufragen.
GetAvailsAPIResponse-Typ
Die Antwort enthält die vollständigen Verfügbarkeitsdaten für den angeforderten Inhalt, einschließlich aller Lizenzbedingungen und territorialen Rechte.
Attribut |
Type |
Ist verpflichtend |
Description |
verfügbar |
Nutzen |
Ja |
Daten zur Verfügbarkeit |
Erfolg |
Boolescher Wert |
Ja |
Status der Operation |
Fehler |
Fehler [] |
Nein |
Liste der Fehler im Fehlerfall |
getAvailsBatchAPIRequest
Ruft mehrere Verfügbarkeitsfenster in einem einzigen API-Aufruf ab. Dies ist effizient, wenn Sie die Rechte für mehrere Titel oder Transaktionen überprüfen müssen.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel anfordern |
GetAvailsBatchAPIRequestItem [] |
Ja |
Liste der individuellen Anfragen |
getAvailsBatchApiResponse
Gibt die Verfügbarkeitsdaten für jeden angeforderten Artikel zurück. Jede Antwort entspricht einer Anfrage über die RequestItemID.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel der Antwort |
GetAvailsBatchAPIResponseItem [] |
Ja |
Liste der Antwortpunkte |
getAvailsBatchApiRequestItem
Jedes Abruf-Element gibt den Pfad zu der Ressource an, die Sie abrufen möchten.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel-ID anfordern |
Zeichenfolge |
Ja |
Eindeutige Kennung des Artikels in der Batch-Anfrage |
Pfad |
Zeichenfolge |
Ja |
Pfad zu einer Ressource für dieses Anforderungselement. |
getAvailsBatchApiResponseItem
Jedes Antwortelement enthält die Verfügbarkeitsdaten, wenn der Abruf erfolgreich war, oder Fehlerdetails, falls er fehlgeschlagen ist.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel-ID anfordern |
Zeichenfolge |
Ja |
Eindeutige Kennung des Artikels in der Batch-Anfrage |
Erfolg |
Boolescher Wert |
Ja |
Status der Operation |
Fehler |
Fehler [] |
Nein |
Liste der Fehler im Fehlerfall |
verfügbar |
Nutzen |
Nein |
Objekt nutzen |
Schema 3 — Validate Avails
Mit diesen Schemas können Sie Ihre Verfügbarkeitsdaten testen, bevor Sie sie an das Prime Video-System senden. Bei der Validierung werden Fehler frühzeitig erkannt, ohne dass tatsächliche Verfügbarkeitsfenster erstellt oder geändert werden müssen.
ValidateAvailsAPIRequest-Typ
Die Validierungsantwort gibt an, ob Ihre Daten alle Validierungsregeln erfüllen. Überprüfen Sie alle Fehler, bevor Sie die eigentliche Erstellungs- oder Aktualisierungsanfrage einreichen.
Attribut |
Type |
Ist verpflichtend |
Description |
verfügbar |
Nutzen |
Ja |
Daten zur Verfügbarkeit |
ValidateAvailsAPIResponse-Typ
Die Validierungsantwort gibt an, ob Ihre Daten alle Validierungsregeln erfüllen. Überprüfen Sie alle Fehler, bevor Sie die eigentliche Erstellungs- oder Aktualisierungsanfrage einreichen.
Attribut |
Type |
Ist verpflichtend |
Description |
Erfolg |
Boolescher Wert |
Ja |
Status der Operation |
Fehler |
Fehler [] |
Nein |
Liste der Fehler im Fehlerfall |
type ValidateAvailsBatchAPIRequest
Validiert mehrere Verfügbarkeitsfenster in einem einzigen Aufruf. Dies ist besonders nützlich, wenn umfangreiche Batch-Übermittlungen vorbereitet werden.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel anfordern |
ValidateAvailsBatchAPIRequestItem [] |
Ja |
Liste der individuellen Anfragen |
Der type ValidateAvailsBatchApiResponse Gibt die Überprüfungsergebnisse für jeden Artikel in Ihrem Stapel
zurück. Jede Antwort entspricht einem Anforderungselement über die RequestItemID.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel der Antwort |
ValidateAvailsBatchAPIResponseItem [] |
Ja |
Liste der Antwortpunkte |
ValidateAvailsBatchApiRequestItem-Typ
Jedes Validierungsanforderungselement enthält den Ressourcenpfad mit angehängtem /validate, um ihn von tatsächlichen Erstellungs- oder Aktualisierungsvorgängen zu unterscheiden.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel-ID anfordern |
Zeichenfolge |
Ja |
Eindeutige Kennung des Artikels in der Batch-Anfrage |
Pfad |
Zeichenfolge |
Ja |
Pfad zu einer Ressource für die Anfrage: |
Körper |
Überprüfen Sie den AvailsBatchAPIRequestItemBody |
Ja |
Hauptteil anfordern |
Der type ValidateAvailsBatchApiRequestItemBody Enthält die zu validierenden Verfügbarkeitsfensterdaten.
Attribut |
Type |
Ist verpflichtend |
Description |
verfügbar |
Nutzen |
Ja |
Daten zur Verfügbarkeit |
type ValidateAvailsBatchApiResponseItem
Jedes Validierungsantwortelement zeigt an, ob die entsprechenden Daten die Gültigkeitsprüfungen bestanden haben.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel-ID anfordern |
Zeichenfolge |
Ja |
Eindeutige Kennung des Artikels in der Batch-Anfrage |
Erfolg |
Boolescher Wert |
Ja |
Status der Operation |
Fehler |
Fehler [] |
Nein |
Liste der Fehler im Fehlerfall |
Schema 4 — Avails löschen
Diese Schemas definieren, wie Verfügbarkeitsfenster aus dem Prime Video-System entfernt werden.
Wichtig: Wir empfehlen dringend, Inhalte nicht zu löschen, sondern durch eine Anpassung des Enddatums ablaufen zu lassen, es sei denn, es handelt sich um spezielle Anwendungsfälle wie die Einhaltung von Compliance-Anforderungen. Bei ablaufenden Inhalten bleiben Ihre historischen Daten und Ihr Prüfprotokoll erhalten, was für die Berichterstattung und den Abgleich von Nutzen ist.
Der type DeleteAvailsAPIResponse
Bestätigt, ob der Löschvorgang erfolgreich abgeschlossen wurde. Überprüfen Sie das Erfolgsfeld und überprüfen Sie alle Fehler.
Attribut |
Type |
Ist verpflichtend |
Description |
Erfolg |
Boolescher Wert |
Ja |
Status der Operation |
Fehler |
Fehler [] |
Nein |
Liste der Fehler im Fehlerfall |
type DeleteAvailsBatchAPIRequest
Löscht mehrere Verfügbarkeitsfenster in einem einzigen API-Aufruf. Dies ist nützlich, wenn mehrere Rechte gelöscht werden oder Rechte ablaufen.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel anfordern |
Löschen Sie AvailsBatchApiRequestItem [] |
Ja |
Liste der individuellen Anfragen |
DeleteAvailsBatchApiResponse-Typ
Gibt die Löschergebnisse für jedes Element in Ihrer Batch-Anfrage zurück.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel der Antwort |
AvailsBatchAPIResponseItem [] löschen |
Ja |
Liste der Antwortpunkte. |
DeleteAvailsBatchApiRequestItem-Typ
Jedes Löschanforderungselement gibt den Pfad zu der zu entfernenden Ressource an.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel-ID anfordern |
Zeichenfolge |
Ja |
Eindeutige Kennung des Artikels in der Batch-Anfrage |
Pfad |
Zeichenfolge |
Ja |
Pfad zu einer Ressource für dieses Anforderungselement. |
DeleteAvailsBatchApiResponseItem-Typ
Jedes Antwortelement bestätigt, ob der Löschvorgang für die entsprechende Anfrage erfolgreich war.
Attribut |
Type |
Ist verpflichtend |
Description |
Artikel-ID anfordern |
Zeichenfolge |
Ja |
Eindeutige Kennung des Artikels in der Batch-Anfrage |
Erfolg |
Boolescher Wert |
Ja |
Status der Operation |
Fehler |
Fehler [] |
Nein |
Liste der Fehler im Fehlerfall |
Kerndatentypen
Diese grundlegenden Datentypen werden in allen API-Schemas verwendet. Das Verständnis dieser Strukturen ist für die Arbeit mit Any-Avails-Operationen unerlässlich. Weitere Informationen finden Sie auf der Seite Inhaltsrechte.
Fehlertyp
Standardfehlerstruktur, die zurückgegeben wird, wenn Operationen fehlschlagen. Der Code identifiziert den Fehlertyp, während die Nachricht menschenlesbare Details enthält.
Attribut |
Type |
Ist verpflichtend |
Description |
Code |
Zeichenfolge |
Ja |
Eine Zeichenfolge, die den Fehlertyp beschreibt. |
Nachricht |
Zeichenfolge |
Ja |
Für Menschen lesbare Beschreibung des Fehlers |
Verfügbarkeitstyp
Die Kerndatenstruktur, die ein vollständiges Verfügbarkeitsfenster darstellt. Dies beinhaltet alle Informationen zu Inhaltsrechten, Lizenzbedingungen, Gebieten und Geschäftsbedingungen.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
ALID |
Zeichenfolge |
Ja |
Gibt die Titel-ID an. Muss mit der im Metadatenbeitrag angegebenen ALID übereinstimmen. |
ALID |
Disposition |
Verfügbare Disposition |
Ja |
Gibt die Granularität des Extraktmodells an. |
N/A |
Lizenzgeber |
Herausgeber |
Ja |
Gibt Informationen über die Entität an, die Prime Video eine Lizenz erteilt. |
N/A |
Vermögenswert |
Verfügbares Objekt [] |
Ja |
Informationen zum Vermögenswert. In der Liste sollte nur ein einzelnes Asset angegeben werden. |
N/A |
Transaktion |
AvailTrans [] |
Ja |
Informationen zur Transaktion. |
N/A |
Gemeinsamer Anspruch |
Verfügbarer geteilter Anspruch [] |
Nein |
Informationen zu Ansprüchen auf andere Dienstleistungen. |
N/A |
AvailDisposition-Typ
Definiert, ob es sich um einen Vorgang zum Full Extract oder zum vollständigen Löschen handelt und ob Daten erstellt/aktualisiert oder gelöscht werden.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
EntryType |
Aufzählung |
Ja |
Zulässige Werte: FullExtract, FullDelete |
Disposition |
Herausgebertyp
Identifiziert Ihre Organisation als Inhaltslizenzgeber. Dieser Wert wird von Prime Video beim Onboarding bereitgestellt.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
DisplayName |
Zeichenfolge |
Ja |
Gibt den Namen des Prime Video-Partners an. Dieser Wert wird Partnern von Prime Video zur Verfügung gestellt. Muss derselbe Wert sein, der in EMA-Dateien verwendet wird. |
DisplayName |
AvailAsset-Typ
Beschreibt das Inhalts-Asset, das lizenziert wird. Die Struktur variiert je nach WorkType (Film, Episode, Staffel usw.).
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
_ContentID |
Zeichenfolge |
Ja |
Gibt die Inhalts-ID für dieses Asset an. In der Regel dasselbe wie ALID. |
ContentID |
WorkType |
Aufzählung |
Ja |
Zulässige Werte: Film, Kurzfilm, Folge, Staffel, Ergänzung |
WorkType |
Metadata |
Verfügbare Unit-Metadaten |
Bedingt |
Beschreibt Metadaten für Film oder Kurzfilm. Erforderlich, wenn WorkType auf Movie oder Short gesetzt ist. |
N/A |
Episoden-Metadaten |
Verfügbare Episoden-Metadaten |
Bedingt |
Beschreibt Metadaten für Episode. Erforderlich, wenn workType auf Episode gesetzt ist. |
N/A |
Metadaten der Saison |
Verfügbare Jahreszeit-Metadaten |
Bedingt |
Beschreibt Metadaten für Staffel. Erforderlich, wenn WorkType auf Staffel ist. |
N/A |
Der AvailSharedTitlement-Typ
Spezifiziert Berechtigungen für andere digitale Ökosysteme wie DMA (Digital Movie Alliance).
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
_Ökosystem |
Aufzählung |
Ja |
Zulässige Werte: DMA |
N/A |
Ökosystem-ID |
Zeichenfolge |
Ja |
Ökosystemspezifischer Titel-Identifier |
DMA_ID |
AvailUnitMetadata vom type
Metadata für eigenständige Inhalte wie Filme oder Kurzfilme.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
TitleInternalAlias |
Zeichenfolge [] |
Ja |
Name des Titels. In der Liste sollte nur ein einziger Titelname angegeben werden. |
TitleInternalAlias |
AvailEpisodeMetadata type Spezifische
Metadata für TV-Folgen, einschließlich der Episodennummer und Informationen zur übergeordneten Staffel/Serie.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
TitleInternalAlias |
Zeichenfolge [] |
Ja |
Titelname für die Episode. In der Liste sollte nur ein einziger Titelname angegeben werden. |
EpisodeTitleInternalAlias |
EpisodeNumber |
Informationen zur Inhaltssequenz |
Ja |
Number dieser Episode innerhalb der Staffel. |
EpisodeNumber |
Metadaten der Saison |
Verfügbare Jahreszeit-Metadaten |
Bedingt |
Beschreibt Metadaten für Staffel. Erforderlich, wenn workType auf Episode oder Staffel ist. |
N/A |
Metadaten der Serie |
Serien-Metadaten verfügbar |
Bedingt |
Beschreibt Metadaten für Serien. Erforderlich, wenn workType auf Episode oder Staffel ist. |
N/A |
AvailSeasonMetadata gibt
Metadata für TV-Staffeln ein, einschließlich Staffelnummer und Anzahl der Folgen.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
SeasonContentID |
Zeichenfolge |
Ja |
ALID für die Saison. |
SeasonContentID |
SeasonTitleInternalAlias |
Zeichenfolge [] |
Nein |
Titelname für die Staffel. In der Liste sollte nur ein einziger Titelname angegeben werden. |
SeasonTitleInternalAlias |
SeasonNumber |
Informationen zur Inhaltssequenz |
Ja |
Number für diese Saison innerhalb der Serie. |
SeasonNumber |
Anzahl der Folgen |
Ganzzahl |
Ja |
Number der Folgen in dieser Staffel. |
EpisodeCount |
Metadaten der Serie |
Serien-Metadaten verfügbar |
Bedingt |
Beschreibt Metadaten für Serien. Erforderlich, wenn WorkType auf Staffel ist. |
N/A |
AvailSeriesMetadata vom type
Metadata für Fernsehserien, die die Serieninformationen der obersten Ebene bereitstellen.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
SeriesContentID |
Zeichenfolge |
Ja |
ALID für Serien. |
SeriesContentID |
SeriesTitleInternalAlias |
Zeichenfolge [] |
Nein |
Titelname für die Serien. In der Liste sollte nur ein einziger Titelname angegeben werden. |
SeriesTitleInternalAlias |
Anzahl der Staffeln |
Ganzzahl |
Nein |
Number der Staffeln in dieser Serie. |
SeasonCount |
AvailTrans-Typ
Definiert eine bestimmte Lizenztransaktion, einschließlich Gebiet, Datum, Lizenztyp und Geschäftsbedingungen. Hier geben Sie an, welche Rechte tatsächlich gewährt werden.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
_TransactionID |
Zeichenfolge |
Nein |
Eindeutiger Bezeichner für das Verfügbarkeitsfenster. Optional bei Verwendung von FullExtract. |
AvailID |
LicenseType |
Aufzählung |
Ja |
Zulässige Werte: SVOD, FVOD, EST, POEST, VOD |
LicenseType |
Gebiet |
Region [] |
Ja |
Gebiet, in dem der Vertrieb erlaubt ist. Es muss nur ein einziger Gebietsartikel angegeben werden. Alle Transaktionen innerhalb eines einzelnen Avail-Objekts müssen dasselbe Gebiet haben. |
Gebiet |
Start |
Datum/Uhrzeit |
Ja |
Startdatum und -uhrzeit für die Verteilung im ISO-Format. HINWEIS: Wenn keine Zeitzone angegeben ist, verwenden wir die östlichste Zeitzone der Region. Sie können jedoch eine beliebige Zeitzone angeben, wenn Sie eine bestimmte Veröffentlichungszeit wünschen. |
Start |
End |
Datum/Uhrzeit |
Nein |
Enddatum und -uhrzeit für die Verteilung im ISO-Format. Falls nicht angegeben, hat die Verteilung eine unbegrenzte Dauer. HINWEIS: Wenn keine Zeitzone angegeben ist, verwenden wir die östlichste Zeitzone der Region. Sie können jedoch eine beliebige Zeitzone angeben, wenn Sie eine bestimmte Takedown-Zeit wünschen. |
End |
AssetLanguage |
AssetLanguage [] |
Nein |
Language für das Asset, ausgedrückt als ISO-Sprachcode mit Asset-Typ. Zulässige Asset-Typen: Untertitel, Audio, Subdub, Sub, Dub, OV, MTA, Beliebig |
AssetLanguage |
AllowedLanguage |
AssetLanguage [] |
Nein |
ISO-Sprachcode mit Asset-Typ. Zulässige Asset-Typen: Untertitel, Audio, Sub, Dub, Subdub, Beliebig |
Zulässige Sprachen |
HoldbackLanguage |
AssetLanguage [] |
Nein |
ISO-Sprachcode mit Asset-Typ. Zulässige Asset-Typen: Untertitel, Audio, Sub, Dub, Subdub, Beliebig |
HoldbackLanguage |
LicenseRightsDescription |
Zeichenfolge |
Nein |
Wird verwendet, um die Veröffentlichungspriorität anzugeben. |
LicenseRightsDescription |
FormatProfile |
AvailFormatProfil |
Ja |
Qualität des verfügbaren Videos. Zulässige Werte: SD, HD, UHD |
FormatProfile |
ContractID |
Zeichenfolge |
Nein |
Spezifiziert Vertragsinformationen. Zulässige Werte: |
ContractID |
Bedingungen |
Verfügbare Bedingungen [] |
Ja |
Gibt die Liste der Geschäftsbedingungen für das Verfügbarkeitsfenster an. |
OtherTerms |
OtherInstructions |
Zeichenfolge |
Nein |
Fenster mit zusätzlichen Verarbeitungsanweisungen für das Verfügbarkeitsfenster. |
OtherInstructions |
Regionstyp
Gibt ein geografisches Gebiet mithilfe von ISO-Ländercodes an.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
country |
Schnur |
Ja |
2-Buchstaben-Ländercode nach ISO 3166-1 |
N/A |
Der AssetLanguage-Typ
Definiert die Sprachverfügbarkeit für Audio- und Untertitel-Assets.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
Wert |
Zeichenfolge |
Ja |
Language für das Asset, ausgedrückt als RFC 5646-Sprachcode mit Asset-Typ. |
N/A |
_Vermögenswert |
Zeichenfolge |
Nein |
Abhängig vom Sprachattribut des AvailTrans-Typs sind unterschiedliche Wertesätze zulässig. |
N/A |
AvailFormatProfile-Typ
Gibt die Videoqualitätsstufe für die Verfügbarkeit an.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
Wert |
Aufzählung |
Ja |
Qualität des verfügbaren Videos. Zulässige Werte: SD, HD, UHD |
N/A |
AvailTerms-Typ
Flexible Struktur zur Angabe von Geschäftsbedingungen. Jeder Begriff hat einen Namen und einen Wert des entsprechenden type (Geld, Text, Ereignis, Boolean, Dauer oder Number).
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
_Begriffsname |
Zeichenfolge |
Ja |
Identifiziert den Begriff. Der Wert unterscheidet nicht zwischen Groß- und Kleinschreibung. Eine Liste der zulässigen Werte finden Sie weiter unten. |
N/A |
Geld |
Geld |
Nein |
Weitere Einzelheiten finden Sie weiter unten. |
N/A |
Text |
Zeichenfolge |
Nein |
Weitere Einzelheiten finden Sie weiter unten. |
N/A |
Ereignis |
Datum/Uhrzeit |
Nein |
Weitere Einzelheiten finden Sie weiter unten. |
N/A |
Boolescher Wert |
Boolescher Wert |
Nein |
Weitere Einzelheiten finden Sie weiter unten. |
N/A |
Dauer |
Zeichenfolge |
Nein |
Weitere Einzelheiten finden Sie weiter unten. |
N/A |
Number |
Ganzzahl |
Nein |
Weitere Einzelheiten finden Sie weiter unten. |
N/A |
Geldtyp
Stellt monetäre Werte mit Währungsspezifikation dar.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
Wert |
Dezimal |
Nein |
Geldwert, für einige Preisarten erforderlich |
N/A |
_Währung |
Zeichenfolge |
Ja |
ISO-Währungscode |
N/A |
Dauertyp
Stellt eine Zeitdauer im ISO 8601-Dauerformat dar. Werte müssen in ganzen Stunden angegeben werden.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
Wert |
Zeichenfolge |
Ja |
ISO 8601-Dauer in ganzen Stunden. Format: PT {N} H wobei {N} eine ganze Zahl von Stunden ist. Zum Beispiel PT48H für 48 Stunden oder PT720H für 30 Tage. |
N/A |
Der type ContentSequenceInfo
Gibt Sequenznummern für Folgen und Staffeln an.
Attribut |
Type |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
Number |
Ganzzahl |
Ja |
Sequenznummer des Inhalts, z. B. Episodennummer oder Staffelnummer |
N/A |
Unterstützte Avail-Bedingungen (HINWEIS: Scrollen Sie nach rechts, um die vollständige EMA-Zuordnung anzuzeigen) In
der folgenden Tabelle sind alle unterstützten Geschäftsbedingungen aufgeführt, die in das AvailTerms-Array aufgenommen werden können. Jeder Begriff regelt bestimmte Aspekte der Lizenzierung, Preisgestaltung, Werbung und Kundenerfahrung.
Name des Begriffs |
Attribut |
Erforderlich |
Hinweise |
EMA-Dateizuordnung |
Identität des Kanals |
Text |
Ja |
Identifier für einen Kanal oder ein Abonnement. |
GroupIdentity |
Stufe |
Text |
Bedingt |
Preisstaffel. Erforderlich, wenn der Lizenztyp POEST ist. |
PriceType |
SRP |
Geld |
Bedingt |
Empfohlener Verkaufspreis. Erforderlich, wenn der Lizenztyp POEST ist. |
SRP |
WSP |
Geld |
Bedingt |
Großhandelspreis. Erforderlich, wenn der Lizenztyp POEST ist. |
PriceValue |
Kategorie |
Text |
Bedingt |
Preiskategorie. Erforderlich, wenn der Lizenztyp POEST ist. |
PriceValue |
AnnounceDate |
Ereignis |
Nein |
Date, an dem der Einzelhändler das Startdatum der Verfügbarkeit des Titels im verfügbaren Gebiet bekannt geben darf. |
AnnounceDate |
SuppressionLiftDate |
Ereignis |
Bedingt |
Am ersten Tag könnte ein Titel öffentlich bekannt gegeben werden, dass er zu einem bestimmten Zeitpunkt in der Zukunft im verfügbaren Gebiet verfügbar sein wird. Erforderlich, wenn der Lizenztyp POEST ist. |
SuppressionLiftDate |
RentalDuration |
Dauer |
Bedingt |
Dauer der Mietdauer in Stunden. Erforderlich, wenn der Lizenztyp SVOD ist. |
RentalDuration |
WatchDuration |
Dauer |
Bedingt |
Wie lange hat der Benutzer Zeit, um die Anzeige nach dem Start abzuschließen, in Stunden. Erforderlich, wenn der Lizenztyp SVOD ist. |
WatchDuration |
Download |
Text |
Nein |
Die Lizenz beinhaltet die Erlaubnis zum Herunterladen. Gültige Werte sind Ja und Nein. Wenn der Lizenztyp SVOD ist, müssen sowohl die Ausleihdauer als auch die Wiedergabedauer angegeben werden. |
Download |
Exklusiv |
Boolescher Wert |
Nein |
Vermögenswerte fallen ausschließlich in den Geltungsbereich der Transaktion. |
Exklusiv |
ExclusiveAttributes |
Text |
Nein |
Gibt die type der Exklusivität an. Wird nur berücksichtigt, wenn Exclusive wahr ist. Wenn Exclusive den Wert true hat, wird ein Standardwert verwendet, sofern er nicht angegeben wird. |
ExclusiveAttributes |
BrandingRights |
Boolescher Wert |
Nein |
Zeigt die Absicht des Partners an, das Branding anzuzeigen. |
BrandingRights |
BrandingRightsAttributes |
Text |
Nein |
Gibt den Branding-Text an. Wird nur berücksichtigt, wenn BrandingRights wahr ist. Wenn BrandingRights den Wert true hat, wird ein Standardwert verwendet, falls er nicht angegeben wird. |
BrandingRightsAttributes |
Werbung zulassen |
Boolescher Wert |
Nein |
Legt fest, ob Werbung erlaubt oder verboten ist. Dieser Begriff kann nur einmal vorkommen. |
Nicht in EMA verfügbar |
Erlaubte Anzeigen-Platzierung |
Text |
Bedingt |
Gibt die Position in der Rolle an, an der Anzeigen eingefügt werden können. Zulässige Werte sind: PreRoll, MidRoll, PostRoll, Overlays, PauseAds, Squeezebacks. |
In EMA nicht verfügbar |
Verbotene Anzeigenschaltung |
Text |
Bedingt |
Gibt die Position in der Rolle an, an der keine Anzeigen eingefügt werden können. Zulässige Werte sind: PreRoll, MidRoll, PostRoll, Overlays, PauseAds, Squeezebacks. |
In EMA nicht verfügbar |
Lieferung und Nutzung von CuePoint |
Text |
Nein |
Spezifiziert die grundlegenden Liefer- und Nutzungspflichten. Zulässige Werte: PartnerWillDelivery und PrimeVideoMust Use, PrimeVideoWillUseIfDelivered, Keine Liefer- oder Nutzungsverpflichtungen, Talent Obligated. |
In EMA nicht verfügbar |
Blindbasis verkauft |
Text |
Nein |
Zulässige Werte: GuaranteedImpressions, NoGuaranteedImpressions |
In EMA nicht verfügbar |
Patenschaften |
Text |
Nein |
Zulässige Werte: Zulässig, Verboten, Zulässig mit Einschränkungen. |
In EMA nicht verfügbar |
Einschränkungen beim Sponsoring |
Text |
Bedingt |
Text in freier Form |
Nicht in EMA verfügbar |
| Richtlinien für Talent- und Amazon-Werbung (** sollte keinen Zeilenumbruch enthalten) |
Text |
Nein |
Zulässige Werte: NoRestrictions, ConsultationRequired |
In EMA nicht verfügbar |
Einschränkungen für Talente |
Text |
Bedingt |
Text in freier Form |
Nicht in EMA verfügbar |
AdLoadLimit |
Text |
Nein |
Number der Werbeminuten pro Stunde. Der Value muss eine gültige Ganzzahl sein. |
In EMA nicht verfügbar |
AdKey |
Text |
Nein |
Freiformtext |
In EMA nicht verfügbar |
CompleteYourBundle (** sollte keinen Zeilenumbruch enthalten) |
Number |
Nein |
Prozentualer Rabatt, der gewährt wird, wenn Kunden ein Paket abschließen, indem sie weitere Titel kaufen, die sie noch nicht besitzen. Ein Rabatt von 20% bedeutet beispielsweise, dass Kunden, die Staffel 1 eines 2-Saison-Pakets besitzen, 20% Rabatt auf Staffel 2 erhalten. |
In EMA nicht verfügbar |
ExcludedFrom (** sollte keinen Zeilenumbruch haben) |
Boolescher Wert |
Nein |
Wenn diese Option auf „true“ gesetzt ist, wird dieses Verfügbarkeitsfenster von der Möglichkeit ausgeschlossen, Rabatte für Pakete zu erhalten. Verwenden Sie es in Premium-Preiszeiträumen (z. B. bei Neuerscheinungen) oder für Titel, für die der volle Preis gelten soll. Wenn der Titel nicht vorhanden oder falsch ist, kann er für Paketrabatte gewährt werden. |
In EMA nicht verfügbar |
BusinessLine-Aufzählung
Die BusinessLine-Aufzählung gibt das Prime Video-Geschäftsmodell an, unter dem Inhalte lizenziert und vertrieben werden. Dies bestimmt, wie Kunden auf die Inhalte zugreifen und wie Einnahmen generiert werden.
Value |
Description |
TVOD |
TVOD bedeutet Kauf oder Miete. Verwandte Lizenztypen: EST, VOD, POEST |
PRIME_SUBSCRIPTION |
Amazon Prime- oder Amazon Kids+ Abonnement. Verwandte Lizenztypen: SVOD |
KANÄLE |
Kanalabonnement eines Drittanbieters. Verwandte Lizenztypen: SVOD |
FVOD |
Kostenlose Inhalte. Verwandte Lizenztypen: FVOD |
Hinweis: Der BusinessLine-Wert bestimmt, welches Geschäftsmodell für Ihre Inhaltsverfügbarkeit gilt. Stellen Sie beim Einreichen von Verfügbarkeiten sicher, dass die BusinessLine Ihrer vertraglichen Vereinbarung mit Prime Video entspricht. Wenn Sie Fragen dazu haben, welche BusinessLine-Werte für Ihre Partnerschaft verfügbar sind, wenden Sie sich an Ihren Prime Video-Vertreter.
Beispielnutzlast Avails
Die folgenden Beispiele zeigen, wie Sie Ihre API-Aufrufe für gängige Integrationsszenarien strukturieren. Vollständige Anforderungs-/Antwortpaare mit ordnungsgemäß formatiertem JSON, die Sie als Vorlagen für Ihre Integration verwenden können, finden Sie unter Payload-Beispiele.
