Video Central

Mit der Angebotsstatus-API kannst du überprüfen, ob deine Titel in der Prime-Video-Storefront verfügbar sind – und wenn nicht, warum. Zentralisiere deine Katalogdaten in deinen eigenen Systemen, anstatt Slate oder die Storefront manuell zu überprüfen. So erhältst du in Echtzeit einen Überblick über alle deine Geschäftsbereiche und Gebiete.

Warum solltest du die Angebotsstatus-API verwenden?

Zentralisierter Betrieb – Ziehe Katalogdaten direkt in deine eigenen Systeme zusammen mit deinen anderen Vertriebskanälen. Du musst dich nicht für jede Statusüberprüfung bei Slate anmelden
Schnellere Problemlösung – Erkenne sofort Verfügbarkeitsprobleme und finde heraus, was deine Titel daran hindert, live zu gehen, wodurch die Lösungszeit um bis zu 3 Tage reduziert wird
Proaktives Katalogmanagement – Überwache deinen gesamten Katalog programmatisch für alle Gebiete und Angebotstypen, sodass du deine Abläufe skalieren kannst, wenn dein Unternehmen wächst
Startüberprüfung in Echtzeit – Erfahre sofort, wann deine Inhalte erfolgreich veröffentlicht wurden, ohne dass du die Storefront manuell überprüfen oder auf Statusaktualisierungen warten musst

Diese schreibgeschützte API ermöglicht es Ihnen, eine Anfrage mit Ihrer Titel-ID (ALID/SKU) zu senden und Statusinformationen in Echtzeit für jede Kombination aus Geschäftsbereich und Region zu erhalten. Sie können Ihre Anfrage optional nach Lizenztyp, Marketplace (Global oder Classic) und/oder Region filtern, um gezielt auf bestimmte Angebote einzugehen.

Was Sie erhalten:
Statusinformationen für jedes Angebot, einschließlich des Gesamtstatus und detaillierter Informationen auf Transaktionsebene. Jeder Status gibt Ihnen Aufschluss darüber, wo Ihr Titel im Veröffentlichungsprozess steht:

Live: Ihr Angebot ist live im Store verfügbar, und das Einkaufswagen-Feld ist vorhanden
In Bearbeitung: Mindestens ein oder alle erforderlichen Ressourcen wurden erfolgreich geliefert und werden gerade aufgenommen. Das Angebot wurde noch nicht erstellt.
Bereit: Alle Assets und Metadaten wurden erfolgreich aufgenommen. Das Angebot wurde entweder 1) erstellt, aber noch nicht veröffentlicht (wird nach der Veröffentlichung live geschaltet), 2) das Angebot wurde entfernt oder entfernt oder 3) das Zeitfenster ist abgelaufen.
Problem: Es wird auf die Lieferung der erforderlichen Ressourcen gewartet (die Lieferung hat noch nicht begonnen); oder mindestens ein benötigtes Asset wurde abgelehnt und muss ersetzt werden.

Anfrage- und Antwortschemas

Dieser Abschnitt enthält technische Spezifikationen für Entwickelnde zur Integration der Angebotsstatus-API in ihre Systeme. Verwende diese Referenz, um das Abfrageformat, die Antwortstruktur und die von der API zurückgegebenen Datentypen zu verstehen.

Anfrageformat

Die Angebotsstatus-API verwendet eine einfache Abruffunktion über die GET-Anfragestruktur, bei der alle Anfrageparameter über die URL übergeben werden – es ist kein Anfragetext erforderlich. Dies erleichtert die Integration in deine Systeme und das Testen mit Standard-HTTP-Clients oder Befehlszeilen-Tools. Erstelle einfach die URL mit deiner Titelkennzeichnung und optionalen Filtern und sende dann eine GET-Anfrage, um den aktuellen Status deiner Angebote abzurufen:

Parameter
Diese Tabelle definiert die Parameter, die du zum Abfragen von Angebotsstatusinformationen verwenden kannst.

Parameter	Typ	Ist verpflichtend	Beschreibung
Lizenzgeber	Zeichenfolge	Ja	Deine Organisationskennung, die von Prime Video beim Onboarding bereitgestellt wurde
ALID	Zeichenfolge	Ja	Titelkennung (ALID oder SKU), die zu deinem Beitrag passt
Marketplace	Zeichenfolge	Nein	Der Amazon Marketplace, bei dem der Titel eingereicht wurde. Dies ist standardmäßig GLOBAL und muss nicht angegeben werden. Zulässige Werte: GLOBAL, USA, DE, JP, GB
Gebiet	Zeichenfolge	Nein	Zweibuchstabiger Gebietscode (z. B. US, GB, AU), mit dem du den Angebotsstatus überprüfen möchtest. Dies ist standardmäßig auf alle Gebiete voreingestellt und muss nicht angegeben werden. Alle Angebotsstatus werden zurückgegeben, wenn dies nicht angegeben wird

Beispielanfragen

Hinweis: Je spezifischer deine Anfrageparameter sind, desto zielgerichteter wird deine Antwort sein. Wenn du optionale Parameter wie Marketplace und Gebiet weglässt, gibt die API Statusinformationen für alle zutreffenden Bereiche zurück, die dieser ALID zugeordnet sind.

Antwortschema

Das Antwortschema definiert die Struktur der Daten, die von der Angebotsstatus-API zurückgegeben werden. Wenn du diese Datentypen verstehst, kannst du die Antwort analysieren und Statusinformationen effektiv in deine Systeme integrieren.

Statusantwort abrufen
Die Antwort auf oberster Ebene, die Informationen zum Angebotsstatus für den angeforderten Titel enthält. Jede Antwort enthält Statusdaten, die nach deinen Anfrageparametern gefiltert wurden, sodass du den Verfügbarkeitsstatus in verschiedenen Geschäftsbereichen und Gebieten nachvollziehen kannst.

Attribut	Typ	Ist verpflichtend	Beschreibung
OfferStatuses	OfferStatus[]	Ja	Reihe von Angebotsstatusobjekten, eines pro Geltungsbereich (Kombination aus Geschäftsbereich/Gebiet)
Fehler	Zeichenfolge	Nein	Liste der Fehler im Fehlerfall

Angebotsstatustyp Die Kerndatenstruktur, die den Status eines einzelnen Angebots darstellt. Dazu gehören allgemeine Statusinformationen und detaillierte Daten auf Transaktionsebene für jedes Verfügbarkeitsfenster.

Attribut	Typ	Ist verpflichtend	Beschreibung
ALID	Zeichenfolge	Ja	Titel-ID, die deinem Metadatenbeitrag entspricht
GroupingEntity	Zeichenfolge	Abhängig	Kennung für einen Channel oder ein Abonnement (erforderlich für SVOD-Angebote)
Lizenzgeber	Herausgeber	Ja	Informationen über deine Organisation, die Prime Video eine Lizenz gewährt
OverallStatus	Status	Ja	Gesamtstatus für alle Fenster im aktuell verfügbaren Kontext/Umfang
PlatformID	Zeichenfolge[]	Ja	Liste der Global Title Identifiers (GTI) für einen Titel
Transaktion	Transaktion[]	Ja	Eine Liste der Verfügbarkeitsfenster und ihrer Status

Art des Herausgebers
Identifiziert deine Organisation als Inhaltslizenzgeber. Dieser Wert wird von Prime Video beim Onboarding bereitgestellt.

Attribut	Typ	Erforderlich	Hinweise
DisplayName	Zeichenfolge	Ja	Anzeigename deiner Organisation
OrganizationID	Zeichenfolge	Ja	Deine Organisationskennung, die Prime Video beim Onboarding angegeben hat (muss mit dem in Avails verwendeten Wert übereinstimmen)

Statustyp
Stellt die allgemeinen Statusinformationen für das Angebot bereit, einschließlich des Datumsbereichs und des aktuellen Fortschrittscodes.

Attribut	Typ	Erforderlich	Hinweise
Kommentare	Zeichenfolge	Nein	Für Menschen lesbare Notizen von Amazon (derzeit null)
Start	Datum	Ja	Frühestes Startdatum des Fensters für den Kontext
Ende	Datum	Ja	Spätestes Enddatum des Fensters für den Kontext.
Fortschrittscode	ENUM	Ja	Fortschrittscode für den Kontext
_Zeitstempel	Datum	Ja	Das letzte Mal, als sich der Status geändert hat oder aktualisiert wurde

Transaktionstyp
Stellt ein einzelnes Verfügbarkeitsfenster mit den zugehörigen Lizenzbedingungen und dem zugehörigen Status dar. Jede Transaktion entspricht einer bestimmten Kombination aus Lizenztyp, Gebiet und Formatprofil.

Attribut	Typ	Erforderlich	Hinweise
ContractID	Zeichenfolge	Ja	Vertrag, mit dem der Titel verknüpft ist
FeatureStatus	FeatureStatus	Ja	Status für das Fenster
Ende	Datum	Ja	Spätestes Enddatum des Fensters für den Kontext
Fortschrittscode	ENUM	Ja	Fortschrittscode für den Kontext
_Zeitstempel	Datum	Ja	Das letzte Mal, als sich der Status geändert hat oder aktualisiert wurde
FormatProfile	FormatProfile[]	Ja	Qualität des verfügbaren Videos. Zulässige Werte: SD, HD, UHD, MAX
LicenseType	Enum	Ja	Zulässige Werte: SVOD, FVOD, EST, POEST, VOD
Gebiet	Zeichenfolge[]	Ja	Gebiet für das Fenster
TransactionID	Zeichenfolge	Nein	Demnächst – wird die AvailID mit Teilextrakten übergeben (derzeit null).

FeatureStatus-Typ
Enthält detaillierte Statusinformationen für ein bestimmtes Verfügbarkeitsfenster, einschließlich des Datumsbereichs und des Fortschrittscodes.

Attribut	Typ	Erforderlich	Hinweise
Kommentare	Zeichenfolge	Nein	Für Menschen lesbare Notizen von Amazon (derzeit null)
Start	Datum	Ja	Startdatum des Fensters
Ende	Datum	Ja	Enddatum des Fensters
Fortschrittscode	ENUM	Ja	Fortschrittscode für das Fenster (derzeit Null – verwende OverallStatus, um festzustellen, ob der Kontext live ist)
_Zeitstempel	Datum	Ja	Das letzte Mal, als sich der Status geändert hat oder aktualisiert wurde

FormatProfile-Typ
Gibt die Videoqualitätsstufe für die Verfügbarkeit an. In einer einzigen Transaktion können mehrere Formatprofile enthalten sein, wenn du deine Inhalte in mehreren Qualitätsstufen (z. B. sowohl HD als auch UHD) verwendet hast.

Attribut	Typ	Erforderlich	Hinweise
value[]	Enum	Ja	Qualität des verfügbaren Videos. Zulässige Werte: SD, HD, UHD, MAX

Hinweis: Die obigen Schemas stellen die aktuelle API-Antwortstruktur dar. Einige Felder (wie Comments, ProgressCode in FeatureStatus und TransactionID) sind derzeit leer, können aber in zukünftigen Versionen gefüllt werden.

Beispiel für eine Antwort

Dieses Beispiel zeigt eine typische API-Antwort für einen SVOD-Titel mit mehreren Verfügbarkeitsfenstern in verschiedenen Gebieten. Die Antwort zeigt, wie Statusinformationen strukturiert sind, einschließlich des Gesamtstatus, der Transaktionsdetails und der Formatprofile.

SVOD-Beispiel:

Häufig gestellte Fragen

Die folgenden Abschnitte enthalten Antworten auf häufig gestellte Fragen zur Arbeit mit der Angebotsstatus-API.