Clientbibliothek einrichten

Die Merchant API ist der offizielle Nachfolger der Content API for Shopping. Die Merchant API befindet sich in der Betaphase.

In den aktuellen Ankündigungen erfahren Sie mehr über neue Funktionen, wichtige Änderungen an der Dokumentation, Fehlerkorrekturen und Release-Updates der Merchant API.

Weitere Informationen dazu, wie Sie festlegen können, wie Ihr Unternehmen und Ihre Produkte auf Google präsentiert werden, und wie Sie programmatisch auf Daten, Statistiken und einzigartige Funktionen zugreifen können, finden Sie unter Einstieg in die Merchant API.

Wir empfehlen, die Google API-Clientbibliotheken zum Einrichten der Content API for Shopping zu verwenden. In diesem Leitfaden werden die Python Content API-Clientbibliotheken als Beispiel verwendet. Sie sind jedoch für viele gängige Programmiersprachen verfügbar und vereinfachen gängige API-Aufgaben wie Authentifizierung, Senden von Anfragen und Parsen von Antworten. Informationen zum Einrichten von Clientbibliotheken für andere Sprachen finden Sie in der README.md für die jeweilige Sprache im googleads/googleads-shopping-samples-Repository auf GitHub.

Hinweis :Sie müssen mehrere erforderliche Bibliotheken installieren, um den Beispielcode in Python verwenden zu können. Aus diesem Grund empfehlen wir, vor dem Fortfahren eine virtuelle Python-Umgebung zu erstellen. Weitere Informationen finden Sie unter Pakete mit Pip und virtuellen Umgebungen installieren.

So richten Sie die Google API-Clientbibliothek für Python ein:

1. Erstellen Sie ein Verzeichnis für die Konfigurations- und Authentifizierungsdateien der Clientbibliothek. Erstellen Sie in Ihrem Basisverzeichnis die folgenden Verzeichnisse:

   ~/shopping-samples/content/

   Hinweis: Dieser Pfad sowie der Dateiname der in Schritt 5 erstellten Datei merchant-info.json sind in der Datei python/shopping/content/common.py im in Schritt 7 heruntergeladenen Verzeichnis mit Content API-Beispielen definiert.

2. So laden Sie die Anmeldedaten für Ihr Dienstkonto herunter:

   1. Rufen Sie die Google API-Bibliothek auf.
   2. Wählen Sie oben auf der Seite im Menü ein Projekt aus. Wenn Sie noch kein Projekt haben, klicken Sie auf Neues Projekt, um eines zu erstellen.
   3. Wenn Sie die Content API for Shopping für dieses Projekt noch nicht aktiviert haben, suchen Sie in der Liste der Google APIs danach und aktivieren Sie sie.
   4. Wähle in der Seitenleiste links Anmeldedaten aus. Möglicherweise müssen Sie oben links auf den nach links weisenden Pfeil klicken, um diese Option zu sehen.
   5. Wenn Sie ein Dienstkonto einrichten möchten, wählen Sie Anmeldedaten erstellen und dann Dienstkonto aus.
   6. Geben Sie einen Namen für das neue Dienstkonto ein. Dieser dient auch als Standardnutzername für die Dienstkonto-ID. Notieren Sie sich die Dienstkonto-ID, einschließlich des Teils nach dem Zeichen „@“, für später. Klicken Sie auf Erstellen und führen Sie dann die optionalen Schritte aus, um Zugriff auf das Projekt und die Nutzer zu gewähren. Klicken Sie dann auf Fertig.
   7. Sie werden zur Seite „Dienstkonten“ weitergeleitet, auf der Sie auf Ihr neues Dienstkonto zugreifen können.

3. Klicken Sie auf das Dienstkonto und dann auf den Tab Schlüssel, um einen privaten JSON-Schlüssel abzurufen. Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen und wählen Sie dann JSON als Schlüsseltyp aus. Klicken Sie auf Erstellen, um den privaten Schlüssel auf Ihren Computer herunterzuladen. Der neue Schlüssel wird automatisch heruntergeladen.

4. Benennen Sie die heruntergeladene Anmeldedatendatei in service-account.json um.

   Hinweis: Dieser Dateiname ist in der Datei _constants.py definiert, die sich im Verzeichnis python/shopping/content/ im in Schritt 7 heruntergeladenen Beispielverzeichnis der Content API befindet.

5. Verschieben Sie die Datei service-account.json in den Ordner home directory/shopping-samples/content/.

6. Erstellen Sie unter home directory/shopping-samples/content/ eine leere Datei merchant-info.json.

7. Fügen Sie in merchant-info.json den folgenden Text hinzu:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

8. Fügen Sie das neue Dienstkonto Ihrem Merchant Center-Konto als Nutzer hinzu. Wenn Sie ein Drittanbieter sind, muss dieser Schritt von Ihrem Kunden ausgeführt werden.

   1. Rufen Sie Ihr Merchant Center-Konto auf.
   2. Wählen Sie in den Einstellungen Ihres Merchant Center-Kontos Personen und Zugriff aus.

   3. Klicken Sie auf + Person hinzufügen und verwenden Sie die Dienstkonto-ID als E-Mail-Adresse für den neuen Nutzer.

      Hinweis :Wenn Sie sich die Dienstkonto-ID nicht notiert haben, rufen Sie die Seite Verwaltung von Dienstkonten auf und wählen Sie das von Ihnen erstellte Projekt aus.

   4. Für die Nutzung des Accounts-Dienstes ist Administratorzugriff erforderlich. Wählen Sie daher Administrator aus.

   5. Klicken Sie auf Nutzer hinzufügen, um die Einstellungen zu speichern und zur Liste der Nutzer zurückzukehren. Die Dienstkonto-ID wird mit der ausgewählten Nutzerrolle aufgeführt.

   6. Wiederholen Sie diesen Vorgang für alle anderen Dienstkonten, die Sie hinzufügen möchten.

9. Klonen Sie das GitHub-Repository googleads/googleads-shopping-samples (oder laden Sie es herunter und entpacken Sie es) an einen beliebigen Speicherort auf Ihrem Computer. Es muss sich nicht in Ihrem Basisverzeichnis oder in ~/shopping-samples/content/ befinden.

10. Wenn Sie das Repository heruntergeladen und entpackt haben, ändern Sie den Namen des entpackten Verzeichnisses in googleads-shopping-samples, anstatt es zu klonen.

11. Um die erforderlichen Abhängigkeiten für die Beispiele zu installieren, rufen Sie in einem Terminalfenster googleads-shopping-samples/python/ auf und führen Sie Folgendes aus:

    pip install -r requirements.txt
    

Sie haben jetzt die Google API-Clientbibliothek für Python konfiguriert und können sie mit der Content API verwenden. Im nächsten Abschnitt erstellen und senden Sie eine Anfrage zum Einfügen eines neuen Produkts.