Python

Google stellt eine Python-Clientbibliothek für die Interaktion mit der Ad Manager API bereit. Wir empfehlen, die Clientbibliothek mit PyPI zu verwenden.

Erstellen Sie dazu ein neues Projekt in der IDE Ihrer Wahl oder fügen Sie die Abhängigkeit einem vorhandenen Projekt hinzu. Google veröffentlicht Clientbibliotheksartefakte auf PyPI als google-ads-admanager.

requirements.txt 

google-ads-admanager==0.10.5

Befehlszeile 

pip install google-ads-admanager

Anmeldedaten konfigurieren

Die Python-Clientbibliothek verwendet OAuth2 und Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) zur Authentifizierung.

ADC sucht in der folgenden Reihenfolge an folgenden Standorten nach Anmeldedaten:

  1. Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS.
  2. Nutzeranmeldedaten, die über die Google Cloud CLI (gcloud CLI) eingerichtet wurden.
  3. Wenn die Anwendung in Google Cloud ausgeführt wird, das Dienstkonto, das an die Google Cloud-Ressource angehängt ist.

Informationen zum Erstellen und Konfigurieren von ADC-Anmeldedaten finden Sie unter Authentifizierung.

Erste Anfrage senden

Jeder Dienst hat ein ServiceClient-Objekt mit synchronen und asynchronen Methoden für jede REST-Methode. Im folgenden Beispiel wird eine Network synchron gelesen.



from google.ads import admanager_v1


def sample_get_network():
    # Create a client
    client = admanager_v1.NetworkServiceClient()

    # Initialize request argument(s)
    request = admanager_v1.GetNetworkRequest(
        name="networks/[NETWORK_CODE]",
    )

    # Make the request
    response = client.get_network(request=request)

    # Handle the response
    print(response)

Beispiele für andere Methoden und Ressourcen finden Sie im GitHub-Repository googleapis/google-cloud-python.

HTTP-Anfragen und ‑Antworten protokollieren

Die Python-Clientbibliothek verwendet die Standard-Python-Bibliothek logging, um HTTP-Anfragen und ‑Antworten zu protokollieren. Standardmäßig ist das Logging deaktiviert.

Zum Aktivieren des Loggings legen Sie die Umgebungsvariable GOOGLE_SDK_PYTHON_LOGGING_SCOPE fest. Mit dieser Umgebungsvariable wird die Verarbeitung von Logging-Ereignissen auf der Ebene logging.DEBUG oder höher konfiguriert.

# Log only Ad Manager API events
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google.ads.admanager_v1

# Log all Google library events
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google

Alternativ können Sie das Python-Modul logging verwenden:

import logging

from google.ads import admanager_v1

logger = logging.getLogger("google.ads.admanager_v1")
logger.addHandler(logging.StreamHandler())
logger.setLevel(logging.DEBUG)

Fehler verarbeiten

Alle API-Fehler erweitern die Basisklasse GoogleAPIError.

Das Feld „Fehlerursache“ identifiziert Fehlertypen eindeutig. Anhand dieses Felds können Sie festlegen, wie der Fehler behandelt werden soll.

try:
  network = client.get_network(request=request)
  print(network)
except GoogleAPIError as e:
  # Handle error
  print(e.reason)

Ad Manager-API-Fehler enthalten auch eine eindeutige requestId, die Sie dem Support zur Fehlerbehebung zur Verfügung stellen können. Im folgenden Beispiel wird die requestId aus einer GoogleAPIError extrahiert:

except GoogleAPIError as e:
  requestInfoType = "type.googleapis.com/google.rpc.RequestInfo"
  requestInfo = [detail for detail in e.details if detail['@type'] == requestInfoType][0]
  print(requestInfo['requestId'])

Proxy-Einstellungen konfigurieren

Die Python-Clientbibliothek berücksichtigt die Einstellungen der Umgebungsvariablen http_proxy und https_proxy.