Clientbibliothek einrichten

Wir empfehlen die Einrichtung der Content API for Shopping mithilfe der Google API-Clientbibliotheken. In diesem Leitfaden werden die Python Content API-Clientbibliotheken als Beispiel verwendet. Sie stehen jedoch für viele gängige Programmiersprachen zur Verfügung 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 Sprache im googleads/googleads-shopping-samples auf GitHub.

Hinweis: Sie müssen mehrere erforderliche Bibliotheken installieren, um den Beispielcode in Python zu verwenden. Aus diesem Grund empfehlen wir, eine virtuelle Python-Umgebung zu erstellen, bevor Sie fortfahren. 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 für die in Schritt 5 erstellte Datei merchant-info.json sind in der Datei python/shopping/content/common.py im Beispielverzeichnis für die Content API definiert, das in Schritt 7 heruntergeladen wurde.

2. Führen Sie die folgenden Schritte aus, um die Anmeldedaten für das Dienstkonto herunterzuladen:

   1. Wähle im Merchant Center im Menü Einstellungen die Option Content API aus.
   2. Klicken Sie auf Authentifizierung.
   3. Klicken Sie auf [+] API-SCHLÜSSEL ERSTELLEN.
   4. Lesen und akzeptieren Sie die Nutzungsbedingungen, wenn Sie dazu aufgefordert werden.

   Der neue Schlüssel wird automatisch heruntergeladen.

3. Benennen Sie die heruntergeladene Datei mit den Anmeldedaten in service-account.json um.

   Hinweis: Dieser Dateiname ist in der Datei _constants.py definiert, die sich in python/shopping/content/ im Beispielverzeichnis für die Content API befindet, das Sie in Schritt 7 heruntergeladen haben.

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

5. Erstellen Sie in der Datei home directory/shopping-samples/content/ eine leere Datei merchant-info.json.

6. Fügen Sie in merchant-info.json den folgenden Text ein:

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

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

8. Wenn Sie das Repository heruntergeladen und entpackt haben, benennen Sie das entpackte Verzeichnis anstelle von Klonen in googleads-shopping-samples um.

9. Rufen Sie googleads-shopping-samples/python/ auf und führen Sie den folgenden Befehl aus, um die erforderlichen Beispielabhängigkeiten zu installieren:

   pip install -r requirements.txt
   

Die Google API-Clientbibliothek für Python ist jetzt konfiguriert und kann mit der Content API verwendet werden. Im nächsten Abschnitt erstellen und senden Sie eine Anfrage zum Einfügen eines neuen Produkts.