Asset Status API

Asset Status API

Zuletzt aktualisiert: 26-01-2026

Mit der Asset Status API kannst du überprüfen, welche Lieferungen für die Veröffentlichung deines Titels erforderlich sind und welchen aktuellen Status jede Lieferung hat (z. B. erfolgreich, fehlgeschlagen, fehlt) – und falls nicht, warum. Zentralisiere deine Asset-Lieferdaten in deinen eigenen Systemen, anstatt Slate manuell zu überprüfen. So erhältst du einen Überblick über alle deine Lieferungen und Asset-Typen in Echtzeit. Du kannst die Asset Status API verwenden, um alle Daten anzuzeigen, die derzeit auf der Registerkarte Assets in Slate verfügbar sind.

Warum solltest du die Asset Status API verwenden?

  • Zentralisierter Betrieb – Ziehe die Daten zur Lieferung von Assets direkt in deinen eigenen Systeme zusammen mit deinen anderen Vertriebskanälen – du musst dich nicht bei jeder Statusüberprüfung bei Slate anmelden
  • Schnellere Problemlösung – Erkenne Lieferprobleme sofort und finde heraus, was deine Titel daran hindert, veröffentlicht zu werden, wodurch die Lösungszeit reduziert wird
  • Proaktives Asset-Management – Überwache deinen gesamten Katalog programmatisch für alle Gebiete und Anlagentypen, sodass du den Betrieb skalieren kannst, wenn dein Unternehmen wächst
  • Lieferüberprüfung in Echtzeit – Erfahre sofort, wann deine Assets erfolgreich geliefert wurden oder ob Fehler vorliegen, die Maßnahmen erfordern


Abfrage- und Antwortschemas

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

Abfrageformat

Die Asset Status API verwendet eine einfache Abfragefunktion über die GET-Abfragestruktur, bei der alle Abfrageparameter über die URL übergeben werden – es ist kein Abfragetext erforderlich. Dies erleichtert die Integration in deine Systeme und das Testen mit Standard-HTTP-Clients oder Befehlszeilentools. Erstelle einfach die URL mit deiner Titelkennung und optionalen Filtern und sende dann eine GET-Abfrage, um den aktuellen Status deiner Asset-Lieferungen abzurufen.

Parameters
Diese Tabelle definiert die Parameter, die du zum Abfragen von Asset-Statusinformationen verwenden kannst.

Parameter

Typ

Ist obligatorisch

Beschreibung

licensor

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

Die Amazon-Website, auf der der Titel eingereicht wurde. Dies ist standardmäßig GLOBAL und muss nicht angegeben werden. Wenn du in deinem Classic-Marketplace-Katalog nach einem Titel suchst, gib diesen bitte als Parameter an.

Zulässige Werte: GLOBAL, US, DE, JP, GB

Beispielabfragen


Hinweis: Je spezifischer deine Abfrageparameter sind, desto zielgerichteter wird deine Antwort sein. Wenn du den optionalen Marketplace-Parameter 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 Asset Status API zurückgegeben werden. Wenn du diese Datentypen verstehst, kannst du die Antwort analysieren und Statusinformationen effektiv in deine Systeme integrieren.

ProductStatus
Die Antwort auf oberster Ebene, die Informationen zum Asset-Status für den abgefragten Titel enthält. Jede Antwort enthält Statusdaten, die nach deinen Abfrageparametern gefiltert wurden, sodass du den Lieferstatus für verschiedene Asset-Typen und Anforderungen nachvollziehen kannst.

Feldbezeichnung

Typ

Ist obligatorisch

Beschreibung

Herkunft

DeliveryPlatform

Ja

Herkunftslieferplattform. Beachte, dass dies immer Prime Video sein sollte.

Ziel

DeliveryPublisher

Ja

Der Partneralias für den Titel, der die Assets erhält.

Umfang

DeliveryScope

Ja

Informationen zum Lieferumfang

PlatformIDs

PlatformIdentifiers

Ja

Plattformkennungen

OverallProgressCode

ProgressCode

Ja

Allgemeiner Fortschrittscode: Bereit, Problem, In Bearbeitung, Fehlt

ProgressDetail

ProgressDetailItem[]

Ja

Liste der Fortschrittsdetails

TitlePartStatus

ProductTitlePartStatus[]

Ja

Statusinformationen zum Titelteil

Anweisungen

ProductDeliveryInstruction[]

Nein

Bereitstellungsanweisungen

DeliveryPlatform-Typ
Informationen zur Herkunftslieferplattform.

Feldbezeichnung

Typ

Ist obligatorisch

Beschreibung

Plattform

Zeichenfolge

Ja

Herkunftslieferplattform. Beachte, dass dies immer Prime Video sein sollte.

DeliveryPublisher-Typ
Informationen zum Zielherausgeber. Dadurch wird deine Organisation als Inhaltsempfänger identifiziert.

Feldbezeichnung

Typ

Ist obligatorisch

Beschreibung

Herausgeber

Zeichenfolge

Ja

Der Partneralias für den Titel, der die Assets erhält.

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

Feldbezeichnung

Typ

Ist obligatorisch

Beschreibung

ALID

Zeichenfolge

Ja

Logische Asset-Kennung oder SKU

Marketplace

Zeichenfolge

Ja

Die Amazon-Website, auf der der Titel eingereicht wurde. Dies ist standardmäßig GLOBAL 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

BenefitID

Zeichenfolge

Nein

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

PlatformIdentifiers-Typ
Struktur der Plattformkennungen, die Titelkennungen enthalten.

Feldbezeichnung

Typ

Erforderlich

Beschreibung

GTI

Zeichenfolge

Ja

Globale Titelkennung

PublisherIDs

PublisherIdentifier[]

Ja

Herausgeberkennungen

PublisherIdentifier-Typ
Die Liste der vom Partner bereitgestellten IDs.

Feldbezeichnung

Typ

Erforderlich

Beschreibung

ALID

Zeichenfolge

Ja

Titelkennung

Marketplace

Zeichenfolge

Ja

Die Amazon-Website, auf der der Titel eingereicht wurde. Dies ist standardmäßig GLOBAL und muss nicht angegeben werden.
Zulässige Werte: GLOBAL, US, DE, JP, GB

ProgressCode-Typ
Werte der Fortschrittscode-Aufzählung, die den Gesamtstatus der Asset-Lieferung angeben.

Wert

Beschreibung

Bereit

Assets wurden aufgenommen

Problem

Es gibt ein Problem mit der Lieferung oder Verarbeitung von Assets

In Bearbeitung

Assets werden geliefert und verarbeitet

Fehlt

Ein bestimmtes Asset wurde noch nicht geliefert

ProgressDetailItem-Typ
Fortschrittsdetail-Artikelstruktur mit zusammenfassenden Statistiken.

Feldbezeichnung

Typ

Erforderlich

Beschreibung

Fortschritt

ProgressCode

Ja

Fortschrittscode

Gesamt

Lang

Ja

Gesamtzahl der Assets

Aktion erforderlich

Lang

Ja

Anzahl der Assets aus der Gesamtzahl, für die Maßnahmen erforderlich sind

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

Feldbezeichnung

Typ

Ist obligatorisch

Beschreibung

PrimaryType

Zeichenfolge

Ja

Der primäre Typ des Assets

SecondaryType

Zeichenfolge

Ja

Sekundärer Typ – Wenn der primäre Typ beispielsweise IMAGE wäre, könnte der Subtyp 2x3 oder Poster sein

FormatProfile

Zeichenfolge

Nein

Formatprofil oder -qualität

Gebietsschema

Zeichenfolge

Nein

Gebietsschema – ex en-US oder es-419

OfferContexts

DeliveryScope[]

Ja

Jeder OfferContext steht für eine bestimmte Angebotskonfiguration (Region, Lizenztyp, Formatprofil usw.), die das Asset verwendet

ConditionalTitleParts

ProductConditionalTitlePart[]

Nein

Bedingt erforderliche Titelteile

RuleType

Zeichenfolge

Ja

Typ der Regel: erforderlich, empfohlen, bedingt erforderlich

ActionType

Zeichenfolge

Ja

Typ der Aktion

RuleSources

String[]

Ja

Quellen für Regeln

LastDelivery

ProductDelivery

Nein

Informationen zur letzten Lieferung

PriorSuccessfulDelivery

ProductDelivery

Nein

Informationen zur vorherigen erfolgreichen Lieferung

FirstDeliveryDate

Zeichenfolge

Nein

Erster Liefertermin

Fortschritt

ProgressCode

Ja

Fortschrittscode: Bereit, Problem, In Bearbeitung, Fehlt

ExpectedDate

Zeichenfolge

Nein

Erwarteter Liefertermin

EarliestStartDate

Zeichenfolge

Nein

Frühestes Startdatum

Allgemeine PrimaryType-Werte
Das Feld PrimaryType identifiziert die Kategorie des Assets, das geliefert wird.

Wert

Beschreibung

METADATA

Titel-Metadaten (Beschreibungen, Besetzung, Crew usw.)

VIDEO

Video-Mezzanine-Dateien

IMAGE

Kunstwerke (Boxkunst, Titelbild, Hero-Bilder, Poster)

AUDIO

Audiospuren

TIMED_TEXT

Untertitel und Bildunterschriften

Allgemeine ActionType-Werte
Das Feld ActionType gibt an, ob du bei einer bestimmten Asset-Lieferung Maßnahmen ergreifen musst.

Wert

Beschreibung

ACTION_NEEDED

Das Asset fehlt oder enthält Fehler, die behoben werden müssen, damit der Titel veröffentlicht werden kann

ACTION_RECOMMENDED

Ein Asset ist nicht erforderlich, wird aber für ein besseres Kundenerlebnis empfohlen

NO_ACTION_NEEDED

Das Asset wurde erfolgreich geliefert, es sind keine Maßnahmen erforderlich

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

Wert

Beschreibung

erforderlich

Muss geliefert werden, damit der Titel veröffentlicht werden kann

empfohlen

Nicht erforderlich, verbessert aber das Kundenerlebnis

bedingt erforderlich

Nur erforderlich, wenn bestimmte Bedingungen erfüllt sind

ProductConditionalTitlePart-Typ
Bedingt erforderliche Titelteilstruktur, die bedingt erforderliche Anforderungen für die Lieferung von Assets definiert.

Feldbezeichnung

Typ

Ist obligatorisch

Beschreibung

RuleType

Zeichenfolge

Ja

Typ der Regel

Regionen

String[]

Ja

Liste der Regionen oder Territorien

TitleParts

ProductTitlePartDescriptor[]

Ja

Titelteile

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

Wert

Beschreibung

NESTED

Alle Titelteile in der Struktur müssen erfüllt sein (UND-Logik)

SINGLE

Jeder der Titelteile erfüllt die Anforderung (ODER-Logik)

ProductTitlePartDescriptor-Typ
Struktur des Titelteildeskriptors, die eine bestimmte Anforderung an den Titelteil definiert.

Feldbezeichnung

Typ

Ist obligatorisch

Beschreibung

PrimaryType

Zeichenfolge

Ja

Der primäre Typ des Assets

SecondaryType

Zeichenfolge

Ja

Sekundärer Typ – Wenn der primäre Typ beispielsweise IMAGE wäre, könnte der Subtyp 2x3 oder Poster sein

FormatProfile

Zeichenfolge

Nein

Formatprofil oder -qualität

Gebietsschema

Zeichenfolge

Nein

Gebietsschema – ex en-US oder es-419

ProductDelivery-Typ
Informationen zur Produktlieferung, die detaillierte Informationen über die Lieferung von Assets enthalten. Dieses Feld ist Null, wenn das Asset noch nicht geliefert wurde.

Feldbezeichnung

Typ

Ist obligatorisch

Beschreibung

Status

Zeichenfolge

Nein

Lieferstatus – NOT_DELIVERED oder SUCCESSFULLY_DELIVERED

FileName

Zeichenfolge

Nein

Dateiname

Hash

Zeichenfolge

Nein

Datei-Hash oder Prüfsumme

DeliveredDate

Zeichenfolge

Nein

Lieferdatum im ISO-8601-Format

Gebietsschema

Zeichenfolge

Nein

Gebietsschema

ServiceProvider

Zeichenfolge

Nein

Dienstleister oder Lieferkonto

PresentationType

Zeichenfolge

Nein

Typ der Präsentation

DynamicRangeType

Zeichenfolge

Nein

Typ des Dynamikbereichs

Anweisungen

ProductDeliveryInstruction[]

Nein

Lieferanweisungen oder Fehler

Allgemeine Statuswerte
Das Feld Status gibt an, ob eine Asset-Lieferung erfolgreich empfangen und verarbeitet wurde.

Wert

Beschreibung

SUCCESSFULLY_DELIVERED

Das Asset wurde erfolgreich geliefert und verarbeitet

NOT_DELIVERED

Das Asset wurde nicht erhalten

ProductDeliveryInstruction-Typ
Struktur mit Anweisungen zur Produktlieferung mit Fehlercodes und Statusinformationen. Anweisungen können in der Antwort auf oberster Ebene (mit einer Zusammenfassung aller Lieferprobleme) oder in ProductDelivery-Objekten (spezifisch für einzelne Asset-Lieferungen) erscheinen.

Feldbezeichnung

Typ

Ist obligatorisch

Beschreibung

TitlePart

ProductTitlePartDescriptor

Nein

Titelteildeskriptor

TitlePartStatus

Zeichenfolge

Nein

Titelteil-Lieferstatus

ErrorCode

Zeichenfolge

Nein

Fehlercode

Regionen

String[]

Nein

Liste der Regionen oder Territorien

Allgemeine TitlePartStatus-Werte
Das Feld TitlePartStatus gibt den Lieferstatus eines Assets in Anweisungsnachrichten an.

Wert

Beschreibung

NOT_DELIVERED

Das Asset wurde nicht geliefert

SUCCESSFULLY_DELIVERED

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. Verwende diese, um die Struktur der Antwortvariablen und die Interpretation von Statusinformationen zu verstehen.

Beispiel 1: Alle Assets wurden erfolgreich geliefert

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

Beispiel 2: Fehlende erforderliche Assets

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


Häufig gestellte Fragen

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

Brauchen Sie noch Hilfe?

Kontaktieren Sie uns


インターナルサーバーエラー、もう一度お試しください。
セッションがタイムアウトしました

続行するにはサインインしてください

サインイン
edit