Angebotsstatus-API

~6 Min. Lesezeit Januar 26, 2026

Mit der Angebotsstatus-API können Sie überprüfen, ob Ihre Titel in der Prime-Video-Storefront verfügbar sind – und wenn nicht, warum. Zentralisieren Sie Ihre Katalogdaten in Ihren eigenen Systemen, anstatt Slate oder die Storefront manuell zu überprüfen. So erhalten Sie in Echtzeit einen Überblick über alle Ihre Geschäftsbereiche und Gebiete.


Warum sollten Sie die Angebotsstatus-API verwenden?

  • Zentralisierter Betrieb – Ziehen Sie Katalogdaten direkt in Ihre eigenen Systeme zusammen mit Ihren anderen Vertriebskanälen. Sie müssen sich nicht für jede Statusüberprüfung bei Slate anmelden
  • Schnellere Problemlösung – Erkennen Sie sofort Verfügbarkeitsprobleme und finden Sie heraus, was Ihre Titel daran hindert, live zu gehen, wodurch die Lösungszeit um bis zu 3 Tage reduziert wird
  • Proaktives Katalogmanagement – Überwachen Sie Ihren gesamten Katalog programmatisch für alle Gebiete und Angebotstypen, sodass Sie Ihre Abläufe skalieren können, wenn Ihr Unternehmen wächst
  • Startüberprüfung in Echtzeit – Erfahren Sie sofort, wann Ihre Inhalte erfolgreich veröffentlicht wurden, ohne dass Sie die Storefront manuell überprüfen oder auf Statusaktualisierungen warten müssen


Anfrage- und Antwortschemas

Dieser Abschnitt enthält technische Spezifikationen für Entwickelnde zur Integration der Angebotsstatus-API in ihre Systeme. Verwenden Sie 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 Ihre Systeme und das Testen mit Standard-HTTP-Clients oder Befehlszeilen-Tools. Erstellen Sie einfach die URL mit Ihrer Titelkennzeichnung und optionalen Filtern und senden Sie dann eine GET-Anfrage, um den aktuellen Status Ihrer Angebote abzurufen:


Parameter
Diese Tabelle definiert die Parameter, die Sie zum Abfragen von Angebotsstatusinformationen verwenden können.

Parameter

Typ

Ist verpflichtend

Beschreibung

Lizenzgeber

Zeichenfolge

Ja

Ihre Organisationskennung, die von Prime Video beim Onboarding bereitgestellt wurde

ALID

Zeichenfolge

Ja

Titelkennung (ALID oder SKU), die zu Ihrem 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 Sie den Angebotsstatus überprüfen möchten. 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 Ihre Anfrageparameter sind, desto zielgerichteter wird Ihre Antwort sein. Wenn Sie optionale Parameter wie Marketplace und Gebiet weglassen, 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 Sie diese Datentypen verstehen, können Sie die Antwort analysieren und Statusinformationen effektiv in Ihre 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 Ihren Anfrageparametern gefiltert wurden, sodass Sie den Verfügbarkeitsstatus in verschiedenen Geschäftsbereichen und Gebieten nachvollziehen können.

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 Ihrem Metadatenbeitrag entspricht

GroupingEntity

Zeichenfolge

Abhängig

Kennung für einen Channel oder ein Abonnement (erforderlich für SVOD-Angebote)

Lizenzgeber

Herausgeber

Ja

Informationen über Ihre Organisation, die Prime Video eine Lizenz gewährt

OverallStatus

Status

Ja

Gesamtstatus für alle Fenster im aktuellen Avail-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 Ihre Organisation als Inhaltslizenzgeber. Dieser Wert wird von Prime Video beim Onboarding bereitgestellt.

Attribut

Typ

Erforderlich

Hinweise

DisplayName

Zeichenfolge

Ja

Anzeigename Ihrer Organisation

OrganizationID

Zeichenfolge

Ja

Ihre 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 – verwenden Sie 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 Sie Ihre Inhalte in mehreren Qualitätsstufen (z. B. sowohl HD als auch UHD) verwendet haben.

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.

Brauchen Sie noch Hilfe?

Kontaktieren Sie uns

In diesem Leitfaden



Interner Ferhler! Bitte erneut versuchen
Die Sitzung ist abgelaufen.

Melden Sie sich an, um fortzufahren.

Anmelden
edit