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:
GOOGLE_APPLICATION_CREDENTIALS
.- Nutzeranmeldedaten, die über die Google Cloud CLI (gcloud CLI) eingerichtet wurden.
- 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
.