Merchant API – Übersicht

Mit der Merchant API haben Sie folgende Möglichkeiten:

  • Sie können festlegen, wie Ihr Unternehmen und Ihre Produkte auf Google präsentiert werden.
  • Programmatischen Zugriff auf Daten, Statistiken und einzigartige Funktionen erhalten
  • Mit Google können Sie mehr Nutzer erreichen und den Umsatz steigern.

Mit der Merchant API lassen sich große oder komplexe Merchant Center-Konten verwalten. Typische Anwendungsfälle:

  • Automatische 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, Angeboten und Rezensionen besser zu organisieren. Mit der Merchant API können Sie Produkte so verwalten, dass sie andere Methoden zum Hochladen von Produktdaten wie Dateien und Autofeed ergänzen. Mit der Merchant API können Sie auch mehrere einzelne Anfragen parallel ausführen.

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

Neues bei der Merchant API

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

Vorbereitung

Zum Ausführen einer Merchant API-Anfrage benötigen Sie Folgendes:

  • Ein Merchant Center-Konto: In diesem Konto werden Daten abgefragt, aktualisiert und hochgeladen. 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 den Link, indem Sie die Methode für die Entwicklerregistrierung aufrufen. Sie verwenden dieses Konto und diese Nutzer für die Kommunikation bezüglich der API-Integration, Umfragen und Möglichkeiten.

  • Verknüpfen Sie Ihr Merchant Center-Konto mit dem Google Cloud-Projekt, indem Sie sich als Entwickler registrieren. Nutzer mit der Rolle „API-Entwickler“ erhalten API-Mitteilungen, darunter obligatorische Servicemitteilungen, Entwicklerumfragen und Informationen zu Möglichkeiten.

Authentifizierung mit der Merchant API

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

  • Sie können eine OAuth 2.0-Client-ID und einen Clientschlüssel für Ihre App generieren. Die ID und der Schlüssel können dann verwendet werden, um die OAuth 2.0-Anmeldedaten zu 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 Produktkennzeichnungen

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

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 :{METHOD}-Teil 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 zum Erstellen einer Ressource den Ressourcennamen der übergeordneten Ressource und diese URL:

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 Dokumentation zur Merchant API-Referenz.

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 Hilfeartikel 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 zu starten:

gRPC (empfohlen) REST
  1. Erstellen Sie den Text der Anfrage 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. Senden Sie sie mit HTTP 1.1 an den Server.
  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 Support für die Merchant API.

Feedback geben

Sie haben dafür folgende Möglichkeiten:

  • API-Funktionen:Wählen Sie im Abschnitt What is the Issue/Question? (Was ist das Problem/die Frage?) des Feedbackformulars die Option Send Feedback (Feedback geben) aus.
  • Dokumentation:Verwenden Sie die Daumen-Bewertungen 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

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

  • 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.

Zurück
Latest updates
Weiter
Design