Python

Google proporciona una biblioteca cliente de Python para interactuar con la API de Ad Manager. Recomendamos usar la biblioteca cliente con PyPI.

Para comenzar, crea un proyecto nuevo en el IDE que prefieras o agrega la dependencia a un proyecto existente. Google publica artefactos de la biblioteca cliente para PyPI como google-ads-admanager

pip install google-ads-admanager

Configura las credenciales

La biblioteca cliente de Python utiliza OAuth2 y las credenciales predeterminadas de la aplicación. (ADC) para autenticarse.

ADC busca las credenciales en orden en las siguientes ubicaciones:

  1. Variable de entorno GOOGLE_APPLICATION_CREDENTIALS.
  2. Credenciales de usuario configuradas a través de Google Cloud CLI (gcloud CLI).
  3. Cuando se ejecuta en Google Cloud, la cuenta de servicio conectada al recurso de Google Cloud

Para crear y configurar tus credenciales de ADC, consulta Autenticación.

Realiza tu primera solicitud

Cada servicio tiene un objeto ServiceClient con métodos síncronos y asíncronos para cada método REST. En el siguiente ejemplo, se lee un Network de forma síncrona.

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

Para ver ejemplos de otros métodos y recursos, consulta el repositorio de GitHub googleapis/google-cloud-python

Cómo solucionar errores

Todos los errores de la API extienden la clase base GoogleAPIError.

El campo del motivo del error identifica de forma única los tipos de error. Usa este campo para determinar cómo manejar el error.

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

Los errores de la API de Ad Manager también incluyen un requestId único que puedes proporcionar al equipo de asistencia para obtener y la solución de problemas. En el siguiente ejemplo, se extrae el requestId desde 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'])

Establece la configuración del proxy

La biblioteca cliente de Python respeta la configuración de la variable de entorno http_proxy. y https_proxy.