Kompatibilität der Content API für Shopping

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.

Hinweis :Wir können keine vollständige Abwärtskompatibilität für ähnliche Funktionen garantieren. zwischen der Content API for Shopping und der Merchant API aufgrund der verbesserten Design. z. B. Feldnamen oder Methodenverfügbarkeit können sich für dieselbe Ressource in der Content API for Shopping und in der Merchant API.

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.

Wichtig: Wir empfehlen, den Wert aus dem Feld name direkt in der aufrufen, anstatt den Namen einer Ressource zu parsen oder manuell zu erstellen, Probleme.

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

Hinweis: Die Merchant API gibt bis November IDs ohne channel-Wert zurück. 13. Oktober 2023. Nach dem 13. November wird bei allen Aufrufen die vollständige Ressourcen-ID zurückgegeben. Ich Sie müssen bis zum 1. Februar in Ihren Aufrufen die vollständige Ressourcen-ID verwenden, einschließlich channel. 2024.

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.