Clientbibliothek einrichten

Deshalb möchten wir die Betaversion der Merchant API einführen. Content API for Shopping ist die neue und künftige Version der Content API for Shopping.

Informationen dazu, wie Sie mit der Merchant API die Einbindung verbessern und die Zukunft mitgestalten können, finden Sie unter Ankündigung der Betaversion der Merchant API.

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

Hinweis: Sie müssen mehrere erforderliche Bibliotheken installieren, um den Beispielcode in Python verwenden zu können. 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 Content API-Beispielverzeichnis definiert, das Sie in Schritt 7 heruntergeladen haben.

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

   1. Wählen Sie 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. Diese befindet sich im Content API-Beispielverzeichnis in Schritt 7 unter python/shopping/content/.

4. Verschieben Sie die Datei service-account.json in das Verzeichnis 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 der Datei merchant-info.json den folgenden Text hinzu:

   {
   "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 (oder laden Sie es herunter und entpacken Sie es) an einem beliebigen Speicherort auf Ihrem Computer. Es muss sich nicht im Basisverzeichnis oder im Verzeichnis ~/shopping-samples/content/ befinden.

8. Wenn Sie das Repository heruntergeladen und entpackt haben, benennen Sie das entpackte Verzeichnis in googleads-shopping-samples um, anstatt es zu klonen.

9. Rufen Sie zum Installieren der erforderlichen Beispielabhängigkeiten in einem Terminalfenster googleads-shopping-samples/python/ auf und führen Sie folgenden Befehl aus:

   pip install -r requirements.txt
   

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