Erste Schritte mit der Merchant API

Auf dieser Seite wird beschrieben, wie Sie ein Merchant Center-Konto erstellen und ein Beispielprodukt mithilfe der Merchant API hochladen können.

Hinweis

Aktivieren Sie die Merchant API in Ihrem Google Cloud-Projekt.

Wenn Sie die API-Integration in Apps Script über den Shopping Content Service verwenden, wird automatisch ein Standard-Google Cloud-Projekt erstellt und der Merchant API-Dienst aktiviert. Sie müssen sich jedoch einmalig als Entwickler registrieren, bevor Sie die Merchant API verwenden können. Weitere Informationen finden Sie unter Merchant API Service in Apps Script verwenden.

Zu Google Cloud

Konto erstellen

Wenn Sie die Merchant API verwenden möchten, benötigen Sie ein Merchant Center-Konto. Weitere Informationen zum Erstellen eines Kontos

Zum Merchant Center

Als Entwickler registrieren

Wenn Sie die Merchant API verwenden möchten, müssen Sie eine Verknüpfung zwischen Ihrem Google Cloud-Projekt und Ihrem primären Merchant Center-Konto erstellen. Diese einmalige Registrierung ist für jedes Google Cloud-Projekt erforderlich, das Sie mit der Merchant API verwenden.

Die Registrierung als Entwickler hat zwei Vorteile:

  • Dadurch wird Ihr Google Cloud-Projekt mit Ihrem primären Merchant Center-Konto verknüpft und eine formale Verbindung hergestellt.
  • Dazu wird eine technische Kontaktperson erstellt, indem einem Nutzer in Ihrem Merchant Center-Konto die Rolle API_DEVELOPER zugewiesen wird. So kann Google Ihnen wichtige Updates zur API senden, z. B. Dienstankündigungen und Informationen zu neuen Funktionen.

Google Cloud-Projekt registrieren

Rufen Sie zum Registrieren die Methode developerRegistration.registerGcp auf. Mit diesem Aufruf wird das Google Cloud-Projekt, das Sie zum Ausführen des Aufrufs verwenden, mit dem Merchant Center-Konto verknüpft, das Sie in der Anfrage angeben.

Im Anfragetext müssen Sie eine Entwickler-E-Mail-Adresse als technischen Kontakt angeben. Diese Adresse muss mit einem Google-Konto (Google Workspace-Konto oder Gmail-Konto) verknüpft sein, z. B. sampleuser@gmail.com. Dienstkonten können nicht verwendet werden, da es sich um nicht menschliche Konten handelt, die für den programmatischen Zugriff und nicht für die Kommunikation mit Entwicklern vorgesehen sind.

  • Wenn die E-Mail-Adresse bereits zu einem Nutzer im Merchant Center-Konto gehört, erhält dieser Nutzer die Rolle API_DEVELOPER.
  • Wenn die E-Mail-Adresse nicht zu einem vorhandenen Nutzer gehört, wird eine Einladung an diese Adresse gesendet. Der Empfänger muss die Einladung annehmen, um als neuer Nutzer mit der Rolle API_DEVELOPER hinzugefügt zu werden.

Hier ein Beispiel für eine Anfrage:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

Ein erfolgreicher Aufruf gibt eine DeveloperRegistration-Ressource zurück, die die Verknüpfung zwischen Ihrem Projekt und Ihrem Konto bestätigt.

{
  "name": "accounts/{ACCOUNT_ID}/developerRegistration",
  "gcpIds": [
    "123456789012345"
  ]
}

Entwicklerkontakte und ‑berechtigungen verwalten

Nach der Registrierung empfehlen wir Ihnen, mehrere Entwickler hinzuzufügen und ihnen zusätzliche Zugriffsrechte zu gewähren.

Zusätzliche Berechtigungen erteilen

Die Rolle API_DEVELOPER ist erforderlich, um wichtige Benachrichtigungen zu erhalten. Sie hat jedoch nur minimale Berechtigungen im Merchant Center. Wenn dieser Nutzer andere API-Aufrufe ausführen oder Einstellungen in der Merchant Center-Benutzeroberfläche verwalten soll, müssen Sie ihm zusätzliche Rollen wie STANDARD oder ADMIN zuweisen. Weitere Informationen finden Sie unter Zugriffstypen.

Sie können die Zugriffsrechte eines Nutzers mit der Methode accounts.users.patch aktualisieren.

Im folgenden Beispiel wird gezeigt, wie Sie einen Nutzer aktualisieren, um ihm sowohl die Rolle ADMIN als auch die Rolle API_DEVELOPER zuzuweisen. So können sie das Konto vollständig verwalten und erhalten auch API-bezogene Mitteilungen.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

Ersatzentwickler hinzufügen

Damit Ihr API-Zugriff nicht unterbrochen wird, wenn Ihr primärer Entwicklerkontakt Ihre Organisation verlässt, sollten Sie mindestens einen Backup-Entwickler hinzufügen.

Sie können einen Nutzer mit der Methode accounts.users.create hinzufügen oder einen vorhandenen Nutzer mit der Methode accounts.users.patch aktualisieren. Wir empfehlen, diesem Nutzer sowohl die Rolle ADMIN als auch die Rolle API_DEVELOPER zuzuweisen.

Primäre Produktdatenquelle erstellen

Um ein Produkt einzufügen, benötigen Sie eine primäre Produktdatenquelle. Die folgende Anfrage zeigt, wie Sie eine Datenquelle erstellen, mit der Sie ein Produkt in Ihr Konto einfügen können:

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1

{
  "primaryProductDataSource": {
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

Ersetzen Sie {ACCOUNT_ID} durch die ID des von Ihnen erstellten Merchant Center-Kontos.

Nachdem Sie diese Anfrage erfolgreich ausgeführt haben, sollte die folgende Antwort angezeigt werden:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

Kopieren Sie den Wert des Felds name. Sie benötigen sie, um ein Produkt einzufügen.

Sie können diese Datenquelle auf der Merchant Center-Benutzeroberfläche aufrufen. Weitere Informationen

Produkt einfügen

Führen Sie die folgende Anfrage aus, um ein Beispielprodukt in Ihr Konto einzufügen:

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

Ersetzen Sie {DATASOURCE_NAME} durch den Wert, den Sie zuvor kopiert haben.

Nachdem Sie diese Anfrage erfolgreich ausgeführt haben, sollte die folgende Antwort angezeigt werden:

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/en~US~tshirt-123",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

Die Produkt-ID für das neu erstellte Produkt lautet en~US~tshirt-123. Mit der Methode accounts.products.get können Sie Details zu diesem Produkt abrufen. Sie können sich dieses Produkt auch in der Merchant Center-Benutzeroberfläche ansehen. Produktdaten ansehen

Zurück
Design
Weiter
Overview