Die Merchant API v1beta wurde am 28. Februar 2026 eingestellt. Eine Anleitung zur Umstellung auf die aktuelle stabile Version finden Sie unter Von v1beta zu v1 migrieren.

Direkte API-Aufrufe

Bei dieser Methode zur Interaktion mit der Merchant API werden Rohanfragen direkt an die API-Endpunkte gesendet, in der Regel über HTTP(S). Sie müssen Aspekte wie das Erstellen des Anfragetexts, das Festlegen von Headern (einschließlich der Authentifizierung) und das Parsen der Antwort manuell verarbeiten.

Schritt 1: Als Entwickler registrieren

Wenn Sie die Merchant API verwenden möchten, müssen Sie die Kontaktdaten Ihres Entwicklers registrieren.

Die Registrierung bietet folgende Vorteile:

Für Ihr Merchant Center-Konto wird ein technischer Kontakt erstellt, indem einem Nutzer die Rolle API developer zugewiesen wird. So kann Google wichtige Updates speziell zur API und zu den Funktionen senden, die der Entwickler verwendet, z. B. Dienstankündigungen und Informationen zu neuen Funktionen, die für Nicht-Entwickler möglicherweise weniger relevant sind.
Sie können mit mehreren Händlerkonten arbeiten, ohne sich mehrmals registrieren zu müssen. Bei der Registrierung wird die Google Cloud-Projekt-ID, die zur Authentifizierung bei der Merchant API verwendet wird, mit Ihrem Merchant Center-Konto verknüpft, das die technischen Kontakte (die API developer) enthält. So erhalten Sie wichtige Updates für alle Händlerkonten, die Sie verwalten, solange die Authentifizierung mit dem registrierten Google Cloud-Projekt erfolgt.

Beachten Sie bei der Registrierung die Voraussetzungen und Einschränkungen, die unter Registrierung aufgeführt sind.

Wenn Sie sich mit der developerRegistration.registerGcp Methode registrieren möchten, können Sie mit diesem Beispiel beginnen und {DEVELOPER_EMAIL} im Anfragetext durch die entsprechende E-Mail-Adresse ersetzen.

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"
  ]
}

Schritt 2: Entwicklerkontakte und -berechtigungen verwalten

Bei der Registrierung gilt Folgendes:

Wenn die E-Mail-Adresse 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.

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

Schritt 2a: Zusätzliche Berechtigungen erteilen

Die Rolle API_DEVELOPER ist erforderlich, um wichtige Benachrichtigungen zu erhalten, bietet aber 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 accounts.users.patch Methode aktualisieren.

Im folgenden Beispiel wird gezeigt, wie Sie einen Nutzer aktualisieren, um ihm sowohl die Rolle ADMIN als auch API_DEVELOPER zu gewähren. So kann er das Konto vollständig verwalten und erhält 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"
  ]
}

Schritt 2b: Backup-Entwickler hinzufügen

Damit der 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 accounts.users.create Methode hinzufügen oder mit accounts.users.patchaktualisieren. Wir empfehlen, diesem Nutzer sowohl die Rolle ADMIN als auch API_DEVELOPER zuzuweisen.

Schritt 3: Primäre Produktdatenquelle erstellen

Zum Einfügen eines Produkts 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

{
  "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 ihn, um ein Produkt einzufügen.

Sie können diese Datenquelle in der Merchant Center-Benutzeroberfläche aufrufen. Weitere Informationen finden Sie unter siehe Tab „Datenquellen“.

Schritt 4: Produkt einfügen

Nachdem Sie die Datenquelle erstellt haben, können Sie versuchen, ein Produkt einzufügen. Führen Sie den folgenden Befehl aus und geben Sie die richtige ACCOUNT_ID an. Ersetzen Sie {DATASOURCE_NAME} durch den Wert, den Sie zuvor kopiert haben.

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME}
{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "productAttributes": {
    "gender": "MALE",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}