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 Teil :{METHOD} wird bei Standardmethoden weggelassen.

Mit dieser 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. Sie wird mit HTTP 1.1 an den Server gesendet. 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 nur die Merchant API-Endpunkte aufrufen, um gRPC zu verwenden.

Hilfe

Informationen zum Support finden Sie 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:Senden Sie das Feedbackformular.
• Dokumentation:Verwenden Sie die Bewertungen auf der Seite und die Schaltfläche Feedback geben.
• Beispiele und Bibliotheken:Verwenden Sie die Schaltfläche Neues Problem auf GitHub.

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