Direkte API-Aufrufe

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

Schritt 1: Als Entwickler registrieren

Wenn Sie die Merchant API verwenden möchten, müssen Sie Ihre Entwicklerkontaktdaten registrieren.

Die Registrierung hat folgende Auswirkungen:

  • 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 zu den Funktionen senden, die der Entwickler verwendet, z. B. Servicemitteilungen und Informationen zu neuen Funktionen, die für Nicht-Entwickler weniger interessant sein könnten.
  • Sie können mehrere Händlerkonten verwenden, ohne sich mehrmals registrieren zu müssen. Bei der Registrierung wird die Google Cloud-Projekt-ID, die für die Authentifizierung bei der Merchant API verwendet wird, Ihrem Merchant Center-Konto zugeordnet, das die technischen Kontakte (die API developer) enthält. So erhalten Sie wichtige Updates für alle Händlerkonten, die Sie verwalten, sofern die Authentifizierung mit dem registrierten Google Cloud-Projekt erfolgt.

Beachten Sie bei der Registrierung die unter Registrierung beschriebenen Voraussetzungen und Einschränkungen.

Wenn Sie sich mit der Methode developerRegistration.registerGcp registrieren möchten, können Sie mit diesem Beispiel beginnen und {DEVELOPER_EMAIL} im Anfragebody 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:

  • 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. Sie hat jedoch nur minimale Berechtigungen im Merchant Center. Wenn Sie diesem Nutzer erlauben möchten, andere API-Aufrufe zu tätigen 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.

Das folgende Beispiel zeigt, 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"
  ]
}

Schritt 2b: 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 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

Um ein Produkt einzufügen, benötigen Sie eine primäre Produktdatenquelle. Im folgenden Beispiel wird gezeigt, 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 auf der Merchant Center-Benutzeroberfläche aufrufen. Weitere Informationen

Schritt 4: Produkt einfügen

Nachdem Sie die Datenquelle erstellt haben, versuchen Sie, 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 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 sich dieses Produkt auch in der Merchant Center-Benutzeroberfläche ansehen. Weitere Informationen zum Aufrufen Ihrer Produktdaten

Zurück
Overview
Weiter
Client libraries