Konfiguration der Python-Clientbibliothek

Python-Clientbibliothek installieren

So installieren Sie die Python-Clientbibliothek in Ihrer lokalen Umgebung:

  1. Entpacken Sie das Tarball-Archiv der Python-Clientbibliothek.

  2. Führen Sie den folgenden Befehl im selben Verzeichnis aus:

    python -m pip install .

  3. Folgen Sie den Eingabeaufforderungen im Terminal, um die Installation abzuschließen.

Konfiguration über YAML-Datei

Sie können eine YAML-Datei angeben, die beim Initialisieren des Clients verwendet werden soll und die erforderlichen Authentifizierungsinformationen für Anfragen enthält. Auf diese Datei wird zugegriffen, wenn ein Client mit der Methode load_from_file initialisiert wird. Folgen Sie dem unten stehenden Beispiel, wenn Sie die YAML-Datei erstellen, um das Aktualisierungstoken, die Client-ID und den Clientschlüssel anzugeben.

Wenn Sie den Speicherort der Datei search-ads-360.yaml angeben möchten, können Sie den Pfad als String an die Methode übergeben, wenn Sie sie aufrufen:

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file("path/to/search-ads-360.yaml")

Wenn Sie keinen Pfad angeben, sucht die Bibliothek im Verzeichnis $HOME nach der Datei:

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file()

Konfigurationsfelder

Die Clientbibliothekskonfiguration unterstützt die folgenden Felder.

Allgemeine Felder:

  • refresh_token: Ihr OAuth-Aktualisierungstoken.
  • client_id: Ihre OAuth-Client-ID.
  • client_secret: Ihr OAuth-Clientschlüssel.
  • login_customer_id: Weitere Informationen finden Sie in der Dokumentation zur Anmelde-Kundennummer.

Unterstützte Schlüssel für Desktop- und Webanwendungs-Flows

Wenn Sie den Desktop- oder Webanwendungsablauf verwenden, werden die folgenden Schlüssel unterstützt:

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_id: INSERT_CLIENT_ID_HERE

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_secret: INSERT_CLIENT_SECRET_HERE

# Renewable OAuth credential associated with 1 or more Search Ads accounts.
refresh_token: INSERT_REFRESH_TOKEN_HERE

# Required for manager accounts only: Specify the login customer ID used to
# authenticate API calls. This will be the customer ID of the authenticated
# manager account. You can also specify this later in code if your application
# uses multiple manager account + OAuth pairs.
#
# login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE