Direkte API-Aufrufe

Bei diesem Ansatz 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 Authentifizierung) und das Parsen der Antwort manuell verarbeiten.

Schritt 1: Als Entwickler registrieren

Wenn Sie die Merchant API verwenden möchten, müssen Sie Ihre Kontaktdaten als Entwickler angeben.

Die Registrierung bewirkt Folgendes:

  • Erstellt einen technischen Kontakt für Ihr Merchant Center-Konto, indem einem Nutzer die Rolle API developer zugewiesen wird. So kann Google wichtige Updates speziell zur API und den vom Entwickler verwendeten Funktionen senden, z. B. Servicemitteilungen und Informationen zu neuen Funktionen, die für Nicht-Entwickler möglicherweise weniger interessant sind.
  • Ermöglicht die Arbeit mit mehreren Händlerkonten, ohne dass Sie sich mehrmals registrieren 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 developers) enthält. So erhalten Sie wichtige Updates für alle von Ihnen verwalteten Händlerkonten, solange die Authentifizierung mit dem registrierten Google Cloud-Projekt erfolgt.

Beachten Sie bei der Registrierung die Voraussetzungen und Einschränkungen, die unter Registrierung beschrieben sind.

Wenn Sie sich mit der Methode developerRegistration.registerGcp 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}"
}

Bei einem erfolgreichen Aufruf wird eine DeveloperRegistration-Ressource zurückgegeben, 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

Wenn Sie sich registrieren, gilt Folgendes:

  • Wenn die E-Mail-Adresse zu einem Nutzer im Merchant Center-Konto gehört, wird diesem Nutzer die Rolle API_DEVELOPER zugewiesen.
  • 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, 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, hat aber nur minimale Berechtigungen im Merchant Center. Wenn Sie diesem Nutzer erlauben möchten, andere API-Aufrufe auszuführen oder Einstellungen in der Merchant Center-Benutzeroberfläche zu verwalten, 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 die Rollen ADMIN und 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"
  ]
}

Schritt 2b: Sekundäre Entwickler hinzufügen

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

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

Schritt 3: Primäre Produktdatenquelle erstellen

Wenn Sie ein Produkt einfügen möchten, 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 sie, um ein Produkt einzufügen.

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

Schritt 4: Produkt einfügen

Nachdem Sie die Datenquelle erstellt haben, versuchen Sie, ein Produkt darin einzufügen. Führen Sie den folgenden Befehl aus und geben Sie dabei den richtigen ACCOUNT_ID an. Ersetzen Sie {DATASOURCE_NAME} durch den zuvor kopierten Wert.

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

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",
  "productAttributes": {
    "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 dieses Produkt auch über die Merchant Center-Benutzeroberfläche aufrufen. Weitere Informationen zum Aufrufen Ihrer Produktdaten finden Sie unter Produktübersicht im Merchant Center.