Video Central

Mit der Asset Status API können Sie überprüfen, welche Lieferungen für die Veröffentlichung Ihres Titels erforderlich sind, sowie den aktuellen Status der einzelnen Sendungen (z. B. erfolgreich, fehlgeschlagen, fehlt) — und wenn nicht, warum. Zentralisieren Sie Ihre Daten zur Auslieferung Ihrer Inhalte in Ihren eigenen Systemen, anstatt Slate manuell zu überprüfen, sodass Sie in Echtzeit einen Überblick über all Ihre Lieferungen und Asset-Typen haben. Sie können die Asset Status API verwenden, um alle Daten anzuzeigen, die derzeit auf der Registerkarte Assets in Slate verfügbar sind.

Warum sollten Sie die Asset Status API verwenden?

Zentralisierter Betrieb — Laden Sie Daten zur Anlagenlieferung zusammen mit Ihren anderen Vertriebskanälen direkt in Ihre eigenen Systeme ab — Sie müssen sich nicht für jede Statusüberprüfung bei Slate anmelden
Schnellere Problemlösung — Erkennen Sie Lieferprobleme sofort und verstehen Sie, was die Veröffentlichung Ihrer Titel verhindert, wodurch die Lösungszeit reduziert wird
Proaktive Vermögensverwaltung — Überwachen Sie Ihren gesamten Katalog programmatisch für alle Gebiete und Anlagearten, sodass Sie Ihre Betriebsabläufe an das Wachstum Ihres Unternehmens anpassen können
Lieferverifizierung in Echtzeit — Sie wissen sofort, wann Ihre Anlagen erfolgreich geliefert wurden oder ob es Fehler gibt, die Maßnahmen erfordern

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 erforderliche Asset-Lieferung zu erhalten. Sie können Ihre Anfrage optional nach Marketplace-Sites filtern, um auf bestimmte Lieferanforderungen einzugehen.

Was Sie erhalten:
Statusinformationen für jedes benötigte Asset, einschließlich des Aktionstyps und detaillierter Lieferinformationen. Jeder Status gibt an, worauf Sie Ihre Aufmerksamkeit richten müssen:

Maßnahme erforderlich: Für dieses bestimmte Asset ist eine Aktion erforderlich, damit der Titel veröffentlicht werden kann. Dies könnte bedeuten, dass das Asset zwar geliefert wurde, aber ein Fehler aufgetreten ist, oder dass es überhaupt nicht geliefert wurde.
Empfohlene Maßnahme: Für die Veröffentlichung des Titels ist keine Maßnahme erforderlich. Wir empfehlen dem Partner jedoch, Maßnahmen zu ergreifen, um die Leistung des Titels zu verbessern, z. B. lokalisiertes Bildmaterial.
Keine Maßnahme erforderlich: Keine weiteren Maßnahmen erforderlich.

Anfrage- und Antwortschemas

Dieser Abschnitt enthält technische Spezifikationen für Entwickler, um die Asset Status API in ihre Systeme zu integrieren. Verwenden Sie diese Referenz, um das Anforderungsformat, die Antwortstruktur und die von der API zurückgegebenen Datentypen zu verstehen.

Format der Anfrage

Die Asset Status API verwendet eine einfache Abruf-von-GET-Anforderungsstruktur, bei der alle Abfrageparameter über die URL übergeben werden — es ist kein Anfragetext erforderlich. Dies erleichtert die Integration in Ihre Systeme und das Testen mithilfe von Standard-HTTP-Clients oder Befehlszeilentools. Erstellen Sie einfach die URL mit Ihrer Titel-ID und optionalen Filtern und senden Sie dann eine GET-Anfrage, um den aktuellen Status Ihrer Asset-Lieferungen abzurufen.

Parameter
Diese Tabelle definiert die Parameter, mit denen Sie Informationen zum Anlagenstatus abfragen können.

Parameter	Type	Ist verpflichtend	Description
Lizenzgeber	Zeichenfolge	Ja	Ihre Unternehmenskennung, die von Prime Video beim Onboarding bereitgestellt wurde
ALID	Zeichenfolge	Ja	Titel-ID (ALID oder SKU), die zu deinem Beitrag passt
Marktplatz	Zeichenfolge	Nein	Der Amazon Marketplace, bei dem der Titel eingereicht wurde. Dieser ist standardmäßig auf GLOBAL voreingestellt und muss nicht angegeben werden. Wenn Sie in Ihrem Classic Marketplace-Katalog nach einem Titel suchen, geben Sie diesen als Parameter an. Zulässige Werte: GLOBAL, US, DE, JP, GB

Beispielanfragen

Hinweis: Je spezifischer Ihre Anfrageparameter sind, desto zielgerichteter wird Ihre Antwort sein. Wenn Sie den optionalen Marketplace-Parameter weglassen, gibt die API Statusinformationen für alle zutreffenden Bereiche zurück, die mit dieser ALID verknüpft sind.

Antwortschema

Das Antwortschema definiert die Struktur der von der Asset Status API zurückgegebenen Daten. Wenn Sie diese Datentypen verstehen, können Sie die Antwort analysieren und Statusinformationen effektiv in Ihre Systeme integrieren.

ProductStatus
Die Antwort auf oberster Ebene, die Informationen zum Asset-Status für den angeforderten Titel enthält. Jede Antwort enthält nach Ihren Anforderungsparametern gefilterte Statusdaten, sodass Sie den Lieferstatus für verschiedene Asset-Typen und Anforderungen nachvollziehen können.

Name des Feldes	Type	Ist verpflichtend	Description
Quelle	Lieferplattform	Ja	Plattform für die Lieferung an die Quelle. Beachten Sie, dass dies immer Prime Video sein sollte.
Ziel	Versand Herausgeber	Ja	Der Partner-Alias für den Titel, der die Vermögenswerte erhält.
Geltungsbereich	Umfang der Lieferung	Ja	Informationen zum Lieferumfang
Plattform-IDs	Plattform-Identifikatoren	Ja	Plattform-Identifikatoren
Allgemeiner Fortschrittscode	Fortschrittscode	Ja	Allgemeiner Fortschrittscode: Bereit, Ausgabe, In Bearbeitung, Fehlend
Einzelheiten zum Fortschritt	ProgressDetailItem []	Ja	Liste der Fortschrittsdetails
TitelTeilStatus	ProdukttitelTeilStatus []	Ja	Informationen zum Status des Titelteils
Anweisungen	Anleitung zur Produktlieferung []	Nein	Anweisungen zur Lieferung

Lieferplattformtyp
Quellinformationen zur Lieferplattform.

Name des Feldes	Type	Ist verpflichtend	Description
Plattform	Schnur	Ja	Plattform für die Lieferung an die Quelle. Beachten Sie, dass dies immer Prime Video sein sollte.

DeliveryPublisher Type
Die Informationen zum Zielverleger ein. Dadurch wird Ihre Organisation als Inhaltsempfänger identifiziert.

Name des Feldes	Type	Ist verpflichtend	Description
Herausgeber	Zeichenfolge	Ja	Der Partner-Alias für den Titel, der die Vermögenswerte erhält.

DeliveryScope Type
Informationen zum Lieferumfang, die den Kontext der Asset-Statusabfrage definieren.

Name des Feldes	Type	Ist verpflichtend	Description
ALID	Zeichenfolge	Ja	Logischer Identifier oder SKU der Anlage
Marktplatz	Zeichenfolge	Ja	Der Amazon Marketplace, auf dem der Titel eingereicht wurde. Dieser ist standardmäßig auf GLOBAL voreingestellt und muss nicht angegeben werden. Zulässige Werte: GLOBAL, US, DE, JP, GB
Region	Zeichenfolge	Nein	Region oder Gebiet
FormatProfile	Zeichenfolge	Nein	Qualität des verfügbaren Videos. Zulässige Werte: SD, HD, UHD, MAX
LicenseType	Zeichenfolge	Nein	Zulässige Werte: SVOD, FVOD, EST, POEST, VOD
Benefit-ID	Zeichenfolge	Nein	Identifier für einen Kanal oder ein Abonnement (erforderlich für SVOD-Angebote)

PlatformIdentifiers Type
Die Struktur der Plattformkennungen ein, die Titelbezeichner enthält.

Name des Feldes	Type	Erforderlich	Description
GTI	Schnur	Ja	Globaler Titelbezeichner
Verlags-IDs	Verlags-ID []	Ja	Identifikatoren des Herausgebers

PublisherIdentifier-Typ
Die Liste der vom Partner bereitgestellten IDs.

Name des Feldes	Type	Erforderlich	Description
ALID	Zeichenfolge	Ja	Titel-ID
Marktplatz	Zeichenfolge	Ja	Der Amazon Marketplace, auf dem der Titel eingereicht wurde. Dieser ist standardmäßig auf GLOBAL voreingestellt und muss nicht angegeben werden. Zulässige Werte: GLOBAL, US, DE, JP, GB

Type ProgressCode
Fortschrittscode-Aufzählungswerte, die den Gesamtstatus der Asset-Lieferung angeben.

Value	Description
Bereit	Vermögenswerte wurden aufgenommen
Problem	Es besteht ein Problem mit der Lieferung oder Verarbeitung von Ressourcen
In Bearbeitung	Vermögenswerte werden geliefert und verarbeitet
Fehlt	Ein bestimmtes Asset wurde noch nicht geliefert

ProgressDetailItem Type
Struktur des Fortschrittsdetailelements, das zusammenfassende Statistiken bereitstellt.

Name des Feldes	Type	Erforderlich	Description
Fortschritt	Fortschrittscode	Ja	Fortschrittscode
Insgesamt	Lang	Ja	Gesamtzahl der Vermögenswerte
Maßnahme erforderlich	Lang	Ja	Number der Assets aus der Gesamtzahl, für die Maßnahmen erforderlich sind

ProductTitlePartStatus Type
Die Kerndatenstruktur, die den Status einer einzelnen erforderlichen Asset-Lieferung darstellt. Dazu gehören der Lieferstatus, die Maßnahmenanforderungen und detaillierte Daten auf Transaktionsebene.

Name des Feldes	Type	Ist verpflichtend	Description
Primärer Typ	Zeichenfolge	Ja	Der primäre Type des Vermögenswerts
Sekundärer Typ	Zeichenfolge	Ja	Sekundärer type — Wenn der primäre type beispielsweise IMAGE war, könnte der Untertyp 2x3 oder Poster sein.
FormatProfile	Zeichenfolge	Nein	Format, Profil oder Qualität
Gebietsschema	Zeichenfolge	Nein	Gebietsschema — ex en-US oder es-419
Kontexte anbieten	Umfang der Lieferung []	Ja	Jeder OfferContext steht für eine bestimmte Angebotskonfiguration (Region, Lizenztyp, Formatprofil usw.), die das Asset verwendet
ConditionalTitleParts	Produkt ConditionalTitlePart []	Nein	Bedingte Titelteile
Regeltyp	Zeichenfolge	Ja	Regeltyp: erforderlich, empfohlen, bedingt
Aktionstyp	Zeichenfolge	Ja	type der Aktion
Quellen für Regeln	Zeichenfolge []	Ja	Regelquellen
Letzte Lieferung	Lieferung des Produkts	Nein	Informationen zur letzten Lieferung
Frühere erfolgreiche Lieferung	Lieferung des Produkts	Nein	Informationen zur vorherigen erfolgreichen Lieferung
Erster Liefertermin	Zeichenfolge	Nein	Erster Liefertermin
Fortschritt	Fortschrittscode	Ja	Fortschrittscode: Bereit, Ausgabe, In Bearbeitung, Fehlt
Voraussichtliches Datum	Zeichenfolge	Nein	Voraussichtlicher Liefertermin
Frühestes Startdatum	Zeichenfolge	Nein	Frühestes Startdatum

Allgemeine PrimaryType
Werte das Feld PrimaryType identifiziert die Kategorie der zu liefernden Anlage.

Value	Description
METADATEN	Metadaten des Titels (Beschreibungen, Besetzung, Crew usw.)
VIDEO	Video-Mezzanine-Dateien
BILD	Kunstwerk (Boxkunst, Titelbild, Heldenbilder, Poster)
AUDIO	Audiotracks
TIMED_TEXT	Untertitel und Bildunterschriften

Allgemeine ActionType
Werte das ActionType-Feld gibt an, ob Sie Maßnahmen für eine bestimmte Asset-Lieferung ergreifen müssen.

Value	Description
ACTION_NEEDED	Das Asset fehlt oder enthält Fehler, die behoben werden müssen, damit der Titel veröffentlicht werden kann
AKTION_RECOMMENDED	Asset ist nicht erforderlich, wird aber für ein besseres Kundenerlebnis empfohlen
KEINE MASSNAHME ERFORDERLICH	Das Asset wurde erfolgreich geliefert, es sind keine Maßnahmen erforderlich

Allgemeine RuleType
Werte Das RuleType-Feld definiert, ob ein Element für die Veröffentlichung Ihres Titels obligatorisch oder optional ist.

Value	Description
erforderlich	Muss geliefert werden, damit der Titel veröffentlicht werden kann
empfohlen	Nicht erforderlich, verbessert aber das Kundenerlebnis
bedingt	Nur erforderlich, wenn bestimmte Bedingungen erfüllt sind

ProductConditionalTitlePart Type
Bedingte Titelteilstruktur, die bedingte Anforderungen für die Lieferung von Assets definiert.

Name des Feldes	Type	Ist verpflichtend	Description
Art der Regel	Zeichenfolge	Ja	type der Regel
Regionen	Zeichenfolge []	Ja	Liste der Regionen oder Territorien
Titel/Teile	Produkttitel Teildeskriptor []	Ja	Teile des Titels

RuleType
Werte Das RuleType-Feld definiert die logische Beziehung zwischen bedingten Titelteilen.

Value	Description
VERSCHACHTELT	Alle Titelteile in der Struktur müssen erfüllt sein (UND-Logik)
EINZELN	Jeder der Titelteile erfüllt die Anforderung (OR-Logik)

ProductTitlePartDescriptor Type
Die Struktur des Titelteils definiert eine bestimmte Anforderung für den Titelteil.

Name des Feldes	Type	Ist verpflichtend	Description
Primärer Typ	Zeichenfolge	Ja	Der primäre Type des Vermögenswerts
Sekundärer Typ	Zeichenfolge	Ja	Sekundärer type — Wenn der primäre type beispielsweise IMAGE war, könnte der Untertyp 2x3 oder Poster sein.
FormatProfile	Zeichenfolge	Nein	Format, Profil oder Qualität
Gebietsschema	Zeichenfolge	Nein	Gebietsschema — ex en-US oder es-419

Produktliefertyp
Produktlieferinformationen mit detaillierten Informationen zu einer Anlagenlieferung. Dieses Feld ist leer, wenn die Anlage noch nicht geliefert wurde.

Name des Feldes	Type	Ist verpflichtend	Description
Status	Zeichenfolge	Nein	Lieferstatus: NOT_DELIVERED oder SUCCESSFULLY_DELIVERED
Dateiname	Zeichenfolge	Nein	Name der Datei
Hash	Zeichenfolge	Nein	Datei-Hash oder Prüfsumme
Lieferdatum	Zeichenfolge	Nein	Lieferdatum im ISO 8601-Format
Gebietsschema	Zeichenfolge	Nein	Gebietsschema
ServiceProvider	Zeichenfolge	Nein	Dienstleister oder Lieferkonto
Art der Präsentation	Zeichenfolge	Nein	type der Presentation
Dynamischer Bereichstyp	Zeichenfolge	Nein	type des Dynamikbereichs
Anweisungen	Anleitung zur Produktlieferung []	Nein	Lieferanweisungen oder Fehler

Allgemeine Statuswerte
Das Statusfeld gibt an, ob eine Anlagenlieferung erfolgreich empfangen und verarbeitet wurde.

Value	Description
ERFOLGREICH AUSGELIEFERT	Das Asset wurde erfolgreich geliefert und verarbeitet
NOT_GELIEFERT	Das Asset wurde nicht empfangen

ProductDeliveryInstruction-Typ
Struktur der produktlieferungsanweisungen mit Fehlercodes und Statusinformationen. Anweisungen können in der Antwort auf oberster Ebene (Zusammenfassung aller Probleme mit der Lieferung) oder innerhalb von ProductDelivery-Objekten (spezifisch für einzelne Warenlieferungen) erscheinen.

Name des Feldes	Type	Ist verpflichtend	Description
Titel/Teil	Produkttitel Teildeskriptor	Nein	Titel, Teil, Deskriptor
Status des Titels des Teils	Zeichenfolge	Nein	Lieferstatus des Titelteils
Fehlercode	Zeichenfolge	Nein	Fehlercode
Regionen	Zeichenfolge []	Nein	Liste der Regionen oder Territorien

Allgemeine TitlePartStatus
Werte Das Feld TitlePartStatus gibt den Lieferstatus einer Anlage in Anweisungsnachrichten an.

Value	Description
NOT_DELIVERED	Das Asset wurde nicht geliefert
ERFOLGREICH AUSGELIEFERT	Das Asset wurde erfolgreich geliefert

Hinweis: Die obigen Schemas stellen die aktuelle API-Antwortstruktur dar und können in zukünftigen Versionen verbessert werden.

Beispiel für eine Antwort

Die folgenden Beispiele zeigen typische API-Antworten für verschiedene Szenarien. Verwenden Sie diese, um die Antwortstruktur und die Interpretation von Statusinformationen zu verstehen.

Beispiel 1: Alle Anlagen wurden erfolgreich geliefert

Dieses Beispiel zeigt eine typische API-Antwort für einen Filmtitel, bei dem alle erforderlichen Ressourcen erfolgreich bereitgestellt wurden. Die Antwort zeigt den Status Bereit an, ohne dass eine Aktion erforderlich ist.

Beispiel 2: Fehlende erforderliche Ressourcen

Dieses Beispiel demonstriert eine API-Antwort, wenn erforderliche Ressourcen fehlen, und zeigt, wie die API den Status ACTION_NEEDED anzeigt und Fehlerinformationen bereitstellt.

Anwendungsfall: Sie haben Metadaten für eine TV-Folge eingereicht, aber die Videodateien noch nicht geliefert. Die API zeigt, welche Videoformate fehlen und blockiert die Veröffentlichung.

Hauptunterschiede zu Beispiel 1:

OverallProgressCode ist „Issue“ statt „Bereit“
ProgressDetail zeigt für ActionNeeded die Anzahl 2 an
TitlePartStatus-Einträge mit dem ActionType „ACTION_NEEDED“ haben den Wert LastDelivery Null
Das Befehls-Array auf oberster Ebene zeigt den Status NOT_DELIVERED
Einige gelieferte Objekte enthalten Validierungswarnungen in ihren Anweisungen

Häufig gestellte Fragen

In den folgenden Abschnitten finden Sie Antworten auf häufig gestellte Fragen zur Arbeit mit der Asset Status API.

Das Befehls-Array bietet detaillierte Fehlercodes und Statusinformationen:

Anweisungen auf oberster Ebene — Zusammenfassung aller Lieferprobleme für alle Anlagen
Anweisungen zur Produktlieferung — Spezifische Warnungen oder Fehler bei Lieferungen einzelner Anlagen
ErrorCode — Identifiziert das spezifische Problem (z. B. Validierungswarnungen, fehlende Abhängigkeiten)
TitlePartStatus — Zeigt an, ob das Asset geliefert wurde (SUCCESSFULLY_DELIVERED, NOT_DELIVERED)