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:
GOOGLE_APPLICATION_CREDENTIALS
.- Credenciais de usuário configuradas com a CLI do Google Cloud (CLI gcloud).
- 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
.