Merchant API – Übersicht

Mit der Merchant API können Sie

  • festlegen, wie Ihr Unternehmen und Ihre Produkte auf Google präsentiert werden.
  • programmatischen Zugriff auf Daten, Statistiken und einzigartige Funktionen erhalten.
  • Ihr Unternehmen ausbauen und mehr Kunden auf Google erreichen.

Mit der Merchant API lassen sich große oder komplexe Merchant Center-Konten verwalten. Zu den typischen Anwendungsfällen gehören:

  • Automatisierte Kontenverwaltung
  • Automatisierte Produktverwaltung
  • Automatisierte Inventarverwaltung
  • Automatisierte Berichtsverwaltung für Leistungs- und Marktstatistiken

Mit der Merchant API können Sie mehrere Datenquellen erstellen und verwalten, um Informationen zu Produkten, Werbeaktionen und Rezensionen besser zu organisieren. Außerdem können Sie Produkte so verwalten, dass sie andere Methoden zum Hochladen von Produktdaten wie Dateien und Autofeedergänzen. Mit der Merchant API lassen sich auch mehrere einzelne Anfragen parallel ausführen.

Die Merchant API ist eine Neuentwicklung der Content API for Shopping. Sie umfasst mehrere Sub-APIs.

Neuerungen in der Merchant API

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

Vorbereitung

Für die Ausführung einer Merchant API-Anfrage benötigen Sie Folgendes:

  • Ein Merchant Center-Konto: Dies ist das Konto, für das Sie Daten abfragen, aktualisieren und hochladen. Prüfen Sie, ob Sie die erforderlichen Berechtigungen zum Verwalten von Produkten und Inventaren in diesem Konto haben.

  • Ein Google Cloud-Projekt: Verwenden Sie das Projekt, um API-Zugriff auf Ihr Konto zu erhalten.

  • Eine Verknüpfung von Ihrem Merchant Center-Konto zum Google Cloud-Projekt. Erstellen Sie die Verknüpfung, indem Sie die Methode zur Entwicklerregistrierung aufrufen. Sie verwenden dieses Konto und diese Nutzer für die Kommunikation in Bezug auf die API-Integration, Umfragen und Möglichkeiten.

Authentifizierung mit der Merchant API

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

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

Konto- und Produktkennungen

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

URL-Format für Anfragen

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 für Standardmethoden wie „list“ und „get“ weggelassen.

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

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

Verwenden Sie den Ressourcennamen der übergeordneten Ressource und diese URL, um eine Ressource zu erstellen:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

Die folgende Anfrage zeigt beispielsweise, wie Sie eine Region für accounts/123456 erstellen können:

POST https://merchantapi.googleapis.com/accounts/v1/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 Referenzdokumentation zur Merchant API.

Erste Schritte mit der Merchant API

Wenn Sie schnell sehen möchten, wie die Merchant API funktioniert, und ein Beispielprodukt hochladen möchten, lesen Sie den Artikel Erste Schritte mit der Merchant API.

gRPC oder REST verwenden

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

gRPC (empfohlen) REST
  1. Erstellen Sie den Anfragetext als Protokollpuffer.
  2. Senden Sie den Anfragetext mit HTTP/2 an den Server.
  3. Deserialisieren Sie die Antwort in einen Protokollpuffer.
  4. Interpretieren Sie die Ergebnisse.
  1. Erstellen Sie den Anfragetext als JSON-Objekt.
  2. Senden Sie ihn mit HTTP 1.1 an den Server.
  3. Deserialisieren Sie die Antwort als JSON-Objekt.
  4. Interpretieren Sie die Ergebnisse.

Clientbibliotheken und Codebeispiele verwenden

Für jede Sub-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 Erhalt von Support finden Sie unter Hilfe zur Merchant API.

Feedback geben

Wenn Sie Feedback geben möchten, senden Sie eines der folgenden Elemente ein:

  • API-Funktionen: Wählen Sie im Feedbackformular unter Was ist das Problem/die Frage? die Option Feedback geben aus.
  • Dokumentation:Verwenden Sie die Daumenbewertungen auf der Seite und die Schaltfläche Feedback geben.
  • Beispiele und Bibliotheken: Erstellen Sie ein Problem im GitHub-Repository für die Codebeispiele.

Nächste Schritte

Zurück
Latest updates
Weiter
Design