Erste Schritte mit der Merchant API

Aktivieren Sie zuerst die Merchant API in Ihrem Cloud-Projekt.

So verwenden Sie die Merchant API:

Clientbibliotheken verwenden

Die Merchant API besteht aus mehreren untergeordneten APIs.

Für jede Unter-API gibt es Codebeispiele und Clientbibliotheken, die Ihnen den Einstieg erleichtern.

Wenn Sie die Content API for Shopping bereits verwenden, lesen Sie den Hilfeartikel Kompatibilität der Content API for Shopping.

Anfragen senden

In der Merchant API werden zur Identifizierung Ressourcennamen anstelle von IDs verwendet. Ein Beispiel für einen Ressourcennamen für ein Produkt ist accounts/123/products/online~en~US~sku123, wobei 123 die eindeutige Kennung des Kontos und online~en~US~sku123 die eindeutige Kennung des Produkts ist.

Wenn Sie eine Ressource bearbeiten möchten, senden Sie Anfragen an URLs im folgenden Format:

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}:{method}

Hinweis: Der :{method}-Teil wird für Standardmethoden weggelassen.

Durch diese Anfrage wird beispielsweise das regionale Inventar gelöscht:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456

Zum Erstellen einer neuen Ressource können Sie den Ressourcennamen der übergeordneten Ressource und die folgende URL verwenden:

POST https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name of parent}/{resource}

So erstellen Sie beispielsweise eine neue Region für account/123:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

Weitere Informationen zu bestimmten Diensten finden Sie in der Referenzdokumentation zur Merchant API.

gRPC oder REST verwenden

Die Merchant API unterstützt gRPC und REST. Es gibt zwei Möglichkeiten, Merchant API-Aufrufe zu starten:

gRPC (empfohlen)	REST
Erstellen Sie den Anfragetext als Protokollzwischenspeicher. Senden Sie den Anfragetext mit HTTP/2 an den Server. Deserialisieren Sie die Antwort in einen Protokollpuffer. Ergebnisse interpretieren:	Erstellen Sie den Anfragetext als JSON-Objekt. Senden Sie sie mit HTTP 1.1 an den Server. Deserialisieren Sie die Antwort als JSON-Objekt. Ergebnisse interpretieren:

Hinweis: Wenn Sie eine Clientbibliothek verwenden, ist gRPC der Standardtransportmechanismus. In den meisten Fällen müssen Sie nichts weiter tun, als die Merchant API-Endpunkte aufzurufen, um gRPC zu verwenden.

Hilfe

Informationen zum Support findest du unter Hilfe zur Merchant API.

Feedback geben

Während der Betaphase können wir Ihr Feedback vor der allgemeinen Verfügbarkeit einholen und berücksichtigen. So geben Sie Feedback:

• API-Funktionen:Reichen Sie das Feedbackformular ein.
• Dokumentation:Verwenden Sie die Bewertungen auf der Seite und die Schaltfläche Feedback geben.
• Beispiele und Bibliotheken:Verwenden Sie die Schaltfläche New issue (Neues Problem) auf GitHub.

Wenn Sie nach der Implementierung jeder Aufgabe allgemeines Feedback geben möchten, verwenden Sie das Feedbackformular.