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 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 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 möglicherweise weniger interessant sind.
• 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 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

Wenn Sie sich registrieren, 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. 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"
  ]
}

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.

Achtung :Wenn der letzte Nutzer mit der Rolle API_DEVELOPER aus Ihrem Merchant Center-Konto entfernt wird, werden Ihre API-Aufrufe nach einer Kulanzfrist von 30 Tagen blockiert. Während dieses Zeitraums erhalten Kontoadministratoren E‑Mail-Warnungen.

Sie können einen Nutzer mit der Methode accounts.users.create hinzufügen oder einen vorhandenen Nutzer 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. 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 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 finden Sie unter Produktdaten ansehen.