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 zuerst ein neues Projekt in der IDE Ihrer Wahl oder fügen Sie die Abhängigkeit einem vorhandenen Projekt hinzu. Google veröffentlicht Clientbibliotheksartefakte in PyPI als google-ads-admanager.

requirements.txt 

google-ads-admanager==0.10.7

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 an folgenden Standorten nach Anmeldedaten:

  1. Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS.
  2. Nutzeranmeldedaten, die über die Google Cloud CLI (gcloud CLI) eingerichtet wurden.
  3. Bei der Ausführung in Google Cloud das Dienstkonto, das an die Google Cloud-Ressource angehängt ist.

Informationen zum Erstellen und Konfigurieren Ihrer 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 ein 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.

Legen Sie die Umgebungsvariable GOOGLE_SDK_PYTHON_LOGGING_SCOPE fest, um das Logging zu aktivieren. Mit dieser Umgebungsvariablen 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.

Im Feld „Fehlerursache“ werden Fehlertypen eindeutig identifiziert. 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 Unterstützung bei der Fehlerbehebung zur Verfügung stellen können. Im folgenden Beispiel wird der requestId aus einem 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 Umgebungsvariablen http_proxy und https_proxy.