Merchant API – Übersicht

Mit der Merchant API können Sie:

  • Sie können festlegen, wie Ihr Unternehmen und Ihre Produkte auf Google präsentiert werden.
  • Programmatischer Zugriff auf Daten, Statistiken und einzigartige Funktionen.
  • Ihr Unternehmen ausbauen und mehr Kunden auf Google erreichen.

Über die Merchant API können große oder komplexe Merchant Center-Konten verwaltet werden. Typische Anwendungsfälle sind:

  • Automatisierte Kontoverwaltung
  • Automatisierte Produktverwaltung
  • Automatisierte Inventarverwaltung
  • Automatisierte Berichtsverwaltung für Leistungs- und Markteinblicke

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 auf eine Weise verwalten, die andere Methoden zum Hochladen von Produktdaten wie Dateien und Autofeed ergänzt. Mit der Merchant API können Sie auch mehrere einzelne Anfragen parallel ausführen.

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

Neuigkeiten zur Merchant API

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

Vorbereitung

Wenn Sie eine Merchant API-Anfrage ausführen möchten, benötigen Sie Folgendes:

  • Ein Merchant Center-Konto: Dies ist das Konto, das Sie abfragen, aktualisieren und in das Sie Daten 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 mit dem Google Cloud-Projekt. Erstellen Sie den Link, indem Sie die Methode zur 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, einschließlich obligatorischer Servicemitteilungen, Entwicklerumfragen und Informationen zu neuen Möglichkeiten.

Authentifizierung mit der Merchant API

Sie können die folgenden Optionen für die Authentifizierung verwenden:

  • Sie können eine OAuth 2.0-Client-ID und ein Secret für Ihre Anwendung generieren. Die ID und das Secret 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 privaten Schlüssel herunterladen, um API-Aufrufe auszuführen.

Konto- und Produktkennzeichnungen

Die Merchant API verwendet zur Identifizierung Ressourcennamen anstelle von IDs. 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.

Format der Anfrage-URL

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/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:

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 Merchant API-Referenzdokumentation.

Erste Schritte mit der Merchant API

Wenn Sie sich einen schnellen Überblick über die Funktionsweise der Merchant API verschaffen 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 auszuführen:

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 Protokollzwischenspeicher.
  4. Ergebnisse interpretieren.
  1. Erstellen Sie den Anfragetext als JSON-Objekt.
  2. Senden Sie sie über HTTP 1.1 an den Server.
  3. Deserialisieren Sie die Antwort als JSON-Objekt.
  4. Ergebnisse interpretieren.

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 Support finden Sie unter Hilfe zur Merchant API.

Feedback geben

Sie haben dafür folgende Möglichkeiten:

  • API-Funktionen: Wählen Sie im Feedbackformular im Abschnitt What is the Issue/Question? (Was ist das Problem/die Frage?) die Option Send Feedback (Feedback geben) aus.
  • Dokumentation: Verwenden Sie die Daumenbewertungen auf der Seite und den Button 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 Kompatibilität der Content API for Shopping.

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

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

Weiter
Merchant API terms and conditions