Python

O Google fornece uma biblioteca de cliente Python para interagir com a API do Ad Manager. Recomendamos usar a biblioteca de cliente com o PyPI.

Para começar, crie um novo projeto no ambiente de desenvolvimento integrado de sua escolha ou adicione o dependência de um projeto atual. O Google publica artefatos da biblioteca de cliente para PyPI como google-ads-admanager.

pip install google-ads-admanager

Configurar credenciais

A biblioteca de cliente do Python usa OAuth2 e Application Default Credentials (ADC) para autenticação.

O ADC pesquisa credenciais em ordem nestes locais:

  1. GOOGLE_APPLICATION_CREDENTIALS.
  2. Credenciais de usuário configuradas com a CLI do Google Cloud (CLI gcloud).
  3. Quando executado no Google Cloud, a conta de serviço anexada ao recurso do Google Cloud.

Para criar e configurar as credenciais do ADC, consulte Autenticação:

Fazer sua primeira solicitação

Cada serviço tem um objeto ServiceClient com objetos síncronos e assíncronos métodos para cada método REST. O exemplo a seguir lê um 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)

Para ver exemplos de outros métodos e recursos, consulte o repositório do GitHub googleapis/google-cloud-python

Solucionar erros

Todos os erros de API estendem a classe base GoogleAPIError.

O campo "Motivo do erro" identifica exclusivamente os tipos de erro. Usar este campo para determinar como lidar com o erro.

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

Os erros da API Ad Manager também incluem um requestId exclusivo que você pode fornecer ao suporte para receber ajuda com e solução de problemas. O exemplo a seguir extrai a requestId de um 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'])

Definir as configurações de proxy

A biblioteca de cliente Python respeita as configurações da variável de ambiente http_proxy e https_proxy.