Python

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

Erstellen Sie zuerst ein neues Projekt in der IDE Ihrer Wahl oder fügen Sie die von einem vorhandenen Projekt abhängig. Google veröffentlicht Clientbibliotheksartefakte in PyPI als google-ads-admanager.

pip install google-ads-admanager

Anmeldedaten konfigurieren

Die Python-Clientbibliothek verwendet OAuth2 und Standardanmeldedaten für Anwendungen. (ADC) authentifizieren.

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

  1. 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 mit der Google Cloud-Ressource verknüpft ist.

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

Erste Anfrage stellen

Jeder Dienst hat ein ServiceClient-Objekt mit synchronem und asynchronem Zugriff. -Methoden für jede REST-Methode. Im folgenden Beispiel wird ein Network gelesen. synchron erfolgen.



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)
admanager_v1_generated_network_service_get_network_sync.py

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

Fehler verarbeiten

Alle API-Fehler erweitern die Basisklasse GoogleAPIError.

Im Feld „Fehlerursache“ werden Fehlertypen eindeutig identifiziert. Mit diesem Feld legen Sie fest, wie mit dem Fehler umgegangen werden soll.

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

Fehler der Ad Manager API umfassen auch eine eindeutige requestId, die Sie Support bei Fragen zu Fehlerbehebung. 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 für Umgebungsvariablen http_proxy und https_proxy.