Product Advertising API (PA-API) 5.0 ist eine komplette Umgestaltung der aktuellen Product Advertising API 4.0. Die API ist einfacher zu integrieren, leichter, schlanker und schneller und bietet Funktionen im Einklang mit der allgemein verbesserten Kundenerfahrung von Amazon Retail.

Dieser Leitfaden hilft dir bei der Umstellung deiner aktuellen Anwendung, die Product Advertising API 4.0 verwendet, auf Product Advertising API 5.0.

Was ist neu in PA-API 5.0?

Product Advertising API 5.0 bietet zusammengefasst folgende neue Funktionen:

• Einfache Integration: Hervorragende SDKs in den gängigsten Sprachen zur einfachen Integration und Übernahme. Die SDKs erleichtern Signatur-Anfragen, Anfragen-Serialisierung und Antworten-De-Serialisierung.
• Leichter, schlanker und schneller: PA-API 5.0 ist von Grund auf aufgebaut, um schnellere Reaktionszeiten zu bieten und verwendet Ressourcen über ResponseGroups. PA-API 5.0 unterstützt das leichtere und schlankere JSON-Format gegenüber XML, das vorher unterstützt wurde.
• Bessere Kundenerfahrung: PA-API 5.0 bietet Funktionen im Einklang mit Amazon Retail, wie LanguageOfPreference-Kompatibilität, PrimeExclusive-Berechtigung, multiple und intuitive Verkaufsplatzierungs-Informationen im Kontext einer bestimmten BrowseNode etc.

Umstellungsprozess

Im folgenden wird die PA-API 4.0 → PA-API 5.0 Umstellungs-Checkliste umrissen:

Folgende Themen enthalten mehr Details zu den oben genannten Schritten.

Schritt 1: Leg neue Zugangsdaten an

Deine aktuellen AWS-Zugangsdaten (AWS-Zugangsschlüssel und AWS-Geheimschlüssel) werden mit PA-API 5.0 nicht funktionieren. Wenn du deine aktuellen AWS-Zugangsdaten hast, kannst du dein Konto umstellen und neue Zugangsdaten generieren. Mehr Details findest du unter Umstellung deines PA-API-Kontos von deinem AWS-Konto.

Wenn du alte AWS-Zugangsdaten hast und folgenden Fehler siehst (Beachte, dass der Fehler-Screenshot aus dem PA-API 5.0 Scratchpad ist), während du PA-API 5.0 testest, musst du eventuell dein PA-API-Konto von deinem AWS-Konto umstellen.

Beachte, dass du, wenn du deine Zugangsdaten von AWS bereits umgestellt hast und über neue Zugangsdaten (nicht-AWS) verfügst, nichts weiter tun musst.

Schritt 2: Teste PA-API 5.0

Bevor du anfängst, Product Advertising API 5.0 zu integrieren, kannst du es mithilfe des PA-API 5.0 Scratchpads ausprobieren.

Das PA-API 5.0 Scratchpad-Tool kann verwendet werden, um Anfragen an die Product Advertising API einzureichen und Antworten zu erhalten. Das Scratchpad-Tool sendet Beispiel-Codes in verschiedenen Sprachen zurück, damit du verstehen kannst, wie die Product Advertising API funktioniert und erleichtert dir die Integration.

Mehr Details findest du im Leitfaden zur Verwendung des Scratchpads.

Schritt 3: Erhalte nötiges Wissen

• PA-API 5.0 verwendet das sicherere HTTPS-POST/JSON-RPC gegenüber dem früheren HTTP(s)-GET/REST,SOAP. PA-API 5.0 unterstützt JSON gegenüber der früheren XML-Unterstützung. Vielleicht möchtest du ein tieferes Verständnis der oben genannten Themen erlangen, bevor du PA-API 5.0 integrierst
• In dem Leitfaden Was ist neu in PA-API 5.0 findest du alle neuen Funktionen, die in Product Advertising API 5.0 unterstützt werden
• Mach dich mit den APIs und Ressourcen, die in PA-API 5.0 unterstützt werden und mit der Syntax des neuen API vertraut. Mehr Details findest du unter API-Referenz. Sieh dir die Darstellung von PA-API 4.0 APIs und ResponseGroups mit PA-API 5.0 im Leitfaden PA-API 4.0 → PA-API 5.0 Darstellungen an.

Schritt 4: Integriere PA-API 5.0

Product Advertising API 5.0 bietet fertige SDKs in den gängigen Sprachen, um deinen Integrationsprozess zu erleichtern. SDKs erleichtern Signatur-Anfragen, die Serialisierung von API-Anfragen und die De-Serialisierung von API-Antworten.

Integriere PA-API 5.0 mithilfe der unterstützten SDKs. Alternativ kannst du eine Implementierung ohne SDKs wählen. Bei der Integration musst du eventuell nur die Komponente aktualisieren, die PA-API-Aufrufe macht und die Komponente, die PA-API-Antworten in dein gewünschtes Format in deiner Anwendung umwandelt.

• Anfrage: Wenn du SDKs verwendest, werden die Signatur-Anfragen, die Serialisierung und die De-Serialisierung von Antworten für dich erledigt. Du findest den Signatur-Algorithmus in diesem Leitfaden sowie in dem Code-Ausschnitt-Bereich des PA-API 5.0 Scratchpad. Eventuell möchtest du auch die Fehlerbehebung in deiner Anwendung zur Verwendung von PA-API-5.0-Fehlern aktualisieren.
• Antwort: Der Antwort-Transformer/-Konverter deiner Anwendung benötigt eventuell ein Update zur Verwendung der neuen JSON-Antwort-Syntax. Sieh dir die API-Referenz zur Überprüfung der Syntax und Platzierung aller Attribute, die dich interessieren, an.