Python

Google stellt eine Python-Client-Bibliothek für die Interaktion mit der Ad Manager API zur Verfügung. 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 Artefakte der Clientbibliothek auf 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 an folgenden Orten 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 an die Google Cloud-Ressource angehängte Dienstkonto.

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 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="name_value",
    )

    # 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

Fehler verarbeiten

Alle API-Fehler erweitern die Basisklasse GoogleAPIError.

Im Feld „Fehlerursache“ werden Fehlertypen eindeutig identifiziert. Verwenden Sie Feld, um festzulegen, 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)

Ad Manager API-Fehler enthalten außerdem eine eindeutige requestId, die Sie dem Support zur Fehlerbehebung mitteilen können. Im folgenden Beispiel wird die requestId von einem GoogleAPIError;

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.