Sie können diesen Leitfaden verwenden, um die Merchant API mit Ihrer bestehenden Content API for Shopping-Implementierung
Erste Schritte
Im Merchant API-Design finden Sie Details zu den Merchant API und die zugehörigen Unter-APIs
Ändern Sie Ihre Anfrage-URLs wie folgt, um die Merchant API zu verwenden Format:
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
Weitere Informationen finden Sie in der Kurzanleitung und finden Sie in der Referenz zur Merchant API weitere Informationen.
gRPC-Unterstützung
Die Merchant API unterstützt gRPC und REST. Sie können gRPC für die Merchant API und REST für die Content API for Shopping gleichzeitig. .
Die Merchant API-Clientbibliotheken erfordern gRPC.
Weitere Informationen finden Sie unter gRPC verwenden. Informationen.
Kompatibilität
In diesem Leitfaden werden allgemeine Änderungen beschrieben, die für die gesamte Merchant API gelten. Weitere Informationen finden Sie unter finden Sie in den folgenden Leitfäden für Änderungen an bestimmten Funktionen:
- Kontoverwaltung migrieren
- Versandeinstellungen migrieren
- Produktverwaltung migrieren
- Datenquellenverwaltung migrieren
- Inventarverwaltung migrieren
- Angebotsverwaltung migrieren
- Berichtsverwaltung migrieren
- Verwaltung von Conversion-Quellen migrieren
- Partnerverwaltung für lokale Feeds migrieren
Die Merchant API lässt sich mit der bestehenden Content API for Shopping kombinieren. Version 2.1 unterstützt.
Sie können beispielsweise die Merchant Inventories API zusätzlich zu Ihren bestehenden
Inventare der Content API for Shopping Version 2.1 und
products
-Implementierung Ich
kann mithilfe der Content API for Shopping eine neue lokale
Produkt (die Sie verkaufen)
in einem lokalen Geschäft) und verwenden Sie dann die Merchant Inventories API.
LocalInventory
Ressource, um Informationen zum jeweiligen Produkt im Geschäft zu verwalten.
Batchanfragen
Die Merchant API unterstützt die Methode customBatch
nicht, die im
Content API for Shopping Weitere Informationen finden Sie unter
-Anfragen. Wenn Sie customBatch
verwenden und
wenn Sie diese Funktion für die Merchant API benötigen, teilen Sie uns in Ihrem
Feedback.
IDs
Gemäß den Prinzipien zur API-Verbesserung von Google haben wir haben einige Änderungen an den IDs für Merchant API-Ressourcen vorgenommen.
Name ersetzt ID
Alle Merchant API-Ressourcen verwenden das Feld name
als eindeutige Kennung.
Hier ein Beispiel für die Verwendung des Felds name
in Ihren Aufrufen:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert
Das neue Feld name
wird als Ressourcen-ID für alle Lese- und
Schreiben von Aufrufen in der Merchant API.
Der in name
-Feldern zurückgegebene Wert verwendet das neue ID-Format.
Implementieren Sie beispielsweise die Methode getName()
, um das name
aus einem
Ressource und speichern Sie die Ausgabe als Variable, anstatt name
zu erstellen.
aus den Händler- und Ressourcen-IDs entfernen.
Neues ID-Format
In der Merchant API haben Ressourcen-IDs das folgende Format:
channel~language~feedLabel~offerId
Content API-Ressourcen, die zwischen den einzelnen Werten in der ID :
statt ~
verwendet haben:
channel:language:feedLabel:offerId
Bei allen Merchant API-Aufrufen wird das neue Format zurückgegeben. Dabei steht ~
zwischen den Werten der
ID. Wir empfehlen, das neue Format aus der Antwort zu speichern und in Ihrem
bei zukünftigen Anrufen.
Übergeordnete Felder für untergeordnete Ressourcen
In der Merchant API haben alle untergeordneten Ressourcen das Feld parent
. Sie können
das Feld parent
, um den name
der Ressource anzugeben, in die das untergeordnete Element eingefügt werden soll.
anstatt die gesamte übergeordnete Ressource zu übergeben. Sie können auch die parent
verwenden
mit list
-Methoden, um die untergeordneten Ressourcen dieser parent
aufzulisten.
Wenn Sie beispielsweise lokale Inventare für ein bestimmtes Produkt auflisten möchten, geben Sie das Attribut
name
des Produkts in der
parent
für das Feld
list
. In diesem Fall ist der angegebene product
der parent
des
LocalInventory
Ressourcen zurückgegeben.
Typen
Im Folgenden sind einige gängige Typen aufgeführt, die in den Unter-APIs der Merchant API gemeinsam genutzt werden.
Preis
Folgendes hat sich für Price
im Merchant Common-Paket geändert:
Content API | Händler-API | |
---|---|---|
Feld „Betrag“ | value:string |
amountMicros:int64 |
Währungsfeld | currency:string
|
currencyCode:string |
Der Betrag in Höhe von Price
wird jetzt in Mikroeinheiten erfasst, wovon 1 Million Mikros entspricht.
der Standardeinheit Ihrer Währung entspricht.
In der Content API for Shopping war Price
eine Dezimalzahl in Form eines
.
Der Name des Betragsfelds wurde von value
in amountMicros
geändert
Der Name des Währungsfelds wurde von currency
in currencyCode
geändert. Die
bleibt ISO 4217.