Merchant API – Übersicht

Auf dieser Seite erhalten Sie eine Einführung in die Merchant API und erfahren, wie Sie damit verschiedene Workflows zur Verwaltung von Konten, Produkten und Inventar im Merchant Center automatisieren können.

Mit der Merchant API können Sie mehr potenzielle Kunden erreichen und Ihre Produkte auf Google präsentieren. Sie können die Merchant API zum Verwalten großer oder komplexer Merchant Center-Konten verwenden. Zu den typischen Anwendungsfällen gehören:

  • Automatische Kontenverwaltung
  • Automatisierte Produktverwaltung
  • Automatisierte Inventarverwaltung
  • Benutzerdefinierte Berichte

Mit der Merchant API können Sie mehrere Datenquellen erstellen und verwalten, um Informationen zu Produkten, Angeboten und Rezensionen besser zu organisieren. Mit der Merchant API können Sie Produkte so verwalten, dass sie andere Uploadmethoden für Produktdaten wie Dateien und Autofeeds ergänzen.

Die Merchant API ist eine Neugestaltung der Content API for Shopping und besteht aus mehreren untergeordneten APIs.

Einzelhändler sind dafür verantwortlich, die Richtlinien für Shopping-Anzeigen und Produkteinträge einzuhalten. Google Shopping behält sich das Recht vor, diese Richtlinien durchzusetzen und entsprechend zu reagieren, wenn wir Inhalte oder Verhaltensweisen finden, die gegen diese Richtlinien verstoßen.

Neuerungen bei der Merchant API

Hier sind einige Gründe für ein Upgrade auf die Merchant API:

Weitere Informationen finden Sie unter Neue Funktionen in der Merchant API Beta.

Vorbereitung

Um eine Merchant API-Anfrage auszuführen, benötigen Sie Folgendes:

  • Ein Merchant Center-Konto: In diesem Konto werden Daten abgefragt, aktualisiert und hochgeladen. Sie benötigen die erforderlichen Berechtigungen, um Produkte und Inventar in diesem Konto zu verwalten.

  • Ein Google Cloud-Projekt: Über das Projekt wird API-Zugriff auf Ihr Konto gewährt.

Authentifizierung mit der Merchant API

Sie haben folgende Möglichkeiten für die Authentifizierung:

  • Sie können eine OAuth 2.0-Client-ID und ein OAuth 2.0-Secret für Ihre App generieren. Mit der ID und dem Secret können dann die OAuth 2.0-Anmeldedaten generiert werden, die für API-Aufrufe an das Merchant Center-Konto erforderlich sind.
  • Sie können ein Dienstkonto erstellen und den privaten Schlüssel herunterladen, um API-Aufrufe auszuführen.

Konto- und Produktkennzeichnungen

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

URL-Format der Anfrage

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}

Der Teil :{METHOD} wird bei Standardmethoden wie „list“ und „get“ weggelassen.

Mit der folgenden Anfrage wird beispielsweise das regionale Inventar gelöscht:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123456/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}

In der folgenden Anfrage wird beispielsweise gezeigt, wie Sie eine neue Region für accounts/123456 erstellen:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

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

Erste Schritte mit der Merchant API

Eine schnelle Übersicht über die Funktionsweise der Merchant API und ein Beispiel für den Upload eines Produkts finden Sie unter Einstieg in die 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
  1. Erstellen Sie den Anfragetext als Protokollzwischenspeicher.
  2. Senden Sie den Anfragetext mit HTTP/2 an den Server.
  3. Deserialisieren Sie die Antwort in einen Protokollpuffer.
  4. Ergebnisse interpretieren:
  1. Erstellen Sie den Anfragetext als JSON-Objekt.
  2. Sie wird mit HTTP 1.1 an den Server gesendet.
  3. Deserialisieren Sie die Antwort als JSON-Objekt.
  4. Ergebnisse interpretieren:

Clientbibliotheken und Codebeispiele verwenden

Für jede untergeordnete API gibt es Clientbibliotheken, die Ihnen den Einstieg erleichtern. Codebeispiele können Ihnen den Einstieg in das Schreiben von Code in Java, PHP und Python erleichtern. Weitere Informationen finden Sie unter Beispiele für die Merchant API.

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:Erstellen Sie ein Problem im GitHub-Repository für die Codebeispiele.

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

Nächste Schritte

  • Informationen zur Abwärtskompatibilität finden Sie unter Kompatibilität der Content API for Shopping.

  • Weitere Informationen zu den wichtigsten Funktionen der Merchant API finden Sie in den Anleitungen im linken Navigationsmenü.

  • Informationen zu den verfügbaren Ressourcen und Diensten finden Sie in der Referenzdokumentation.

Weiter
Design