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.
So richten Sie die Google API-Clientbibliothek für Python ein:
Erstellen Sie ein Verzeichnis für die Konfigurations- und Authentifizierungsdateien der Clientbibliothek. Erstellen Sie in Ihrem Basisverzeichnis die folgenden Verzeichnisse:
~/shopping-samples/content/
So laden Sie die Anmeldedaten für Ihr Dienstkonto herunter:
- Rufen Sie die Google API-Bibliothek auf.
- 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.
- 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.
- 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.
- Wenn Sie ein Dienstkonto einrichten möchten, wählen Sie Anmeldedaten erstellen und dann Dienstkonto aus.
- 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.
- Sie werden zur Seite „Dienstkonten“ weitergeleitet, auf der Sie auf Ihr neues Dienstkonto zugreifen können.
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.
Benennen Sie die heruntergeladene Anmeldedatendatei in service-account.json um.
Verschieben Sie die Datei service-account.json in den Ordner home directory/shopping-samples/content/.
Erstellen Sie unter home directory/shopping-samples/content/ eine leere Datei merchant-info.json.
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" }
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.
- Rufen Sie Ihr Merchant Center-Konto auf.
- Wählen Sie in den Einstellungen Ihres Merchant Center-Kontos Personen und Zugriff aus.
Klicken Sie auf + Person hinzufügen und verwenden Sie die Dienstkonto-ID als E-Mail-Adresse für den neuen Nutzer.
Für die Nutzung des
Accounts
-Dienstes ist Administratorzugriff erforderlich. Wählen Sie daher Administrator aus.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.
Wiederholen Sie diesen Vorgang für alle anderen Dienstkonten, die Sie hinzufügen möchten.
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.
Wenn Sie das Repository heruntergeladen und entpackt haben, ändern Sie den Namen des entpackten Verzeichnisses in googleads-shopping-samples, anstatt es zu klonen.
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.