Python

Google fornisce una libreria client Python per interagire con l'API Ad Manager. Ti consigliamo di utilizzare la libreria client con PyPI.

Per iniziare, crea un nuovo progetto nell'IDE di tua scelta o aggiungi a un progetto esistente. Google pubblica gli elementi della libreria client su PyPI come google-ads-admanager.

pip install google-ads-admanager

Configura le credenziali

La libreria client Python utilizza OAuth2 e le credenziali predefinite dell'applicazione (ADC) per l'autenticazione.

ADC cerca le credenziali in ordine nelle seguenti posizioni:

  1. GOOGLE_APPLICATION_CREDENTIALS variabile di ambiente.
  2. Credenziali utente configurate tramite Google Cloud CLI (gcloud CLI).
  3. Durante l'esecuzione su Google Cloud, l'account di servizio associato alla risorsa Google Cloud.

Per creare e configurare le credenziali ADC, consulta Autenticazione.

Effettua la tua prima richiesta

Ogni servizio ha un oggetto ServiceClient con istanze sincrone e asincrone per ogni metodo REST. L'esempio seguente legge una Network in modo sincrono.

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

Per esempi di altri metodi e risorse, consulta il repository GitHub googleapis/google-cloud-python.

Gestire gli errori

Tutti gli errori dell'API estendono la classe base GoogleAPIError.

Il campo del motivo dell'errore identifica in modo univoco i tipi di errore. Utilizza le funzionalità di questo campo per determinare come gestire l'errore.

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

Gli errori dell'API Ad Manager includono anche un requestId univoco che puoi fornire all'assistenza aiuto per risoluzione dei problemi. L'esempio seguente estrae il parametro requestId da un 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'])

Configurare le impostazioni proxy

La libreria client Python rispetta le impostazioni delle variabili di ambiente http_proxy e https_proxy.