Configuração da biblioteca de cliente do Python

Instalar a biblioteca de cliente do Python

Para instalar a biblioteca de cliente Python no seu ambiente local:

  1. Extraia o tarball da biblioteca de cliente do Python.
  2. Execute este comando no mesmo diretório:

    python -m pip install .
    
  3. Siga as instruções no terminal para concluir a instalação.

Configuração usando o arquivo YAML

É possível especificar um arquivo YAML a ser usado ao inicializar o cliente que contenha as informações de autenticação necessárias para fazer solicitações. Esse arquivo é acessado quando um cliente é inicializado usando o método load_from_file. Siga o exemplo fornecido abaixo ao criar o arquivo YAML para especificar o token de atualização, o ID e a chave secreta do cliente.

Para especificar o local em que o arquivo search-ads-360.yaml está localizado, transmita o caminho como uma string para o método ao chamá-lo:

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file("path/to/search-ads-360.yaml")

Se você não informar um caminho, a biblioteca vai procurar o arquivo no diretório $HOME:

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file()

Campos de configuração

A configuração da biblioteca de cliente é compatível com os campos a seguir.

Campos gerais:

  • refresh_token: seu token de atualização de OAuth.
  • client_id: seu ID do cliente OAuth.
  • client_secret: a chave secreta do cliente OAuth.
  • login_customer_id: consulte a documentação login-customer-id.

Chaves compatíveis para fluxos de aplicativos da Web e de computador

Se você estiver usando o fluxo de aplicativo para computadores ou Web, as chaves compatíveis serão as seguintes:

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_id: INSERT_CLIENT_ID_HERE

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_secret: INSERT_CLIENT_SECRET_HERE

# Renewable OAuth credential associated with 1 or more Search Ads accounts.
refresh_token: INSERT_REFRESH_TOKEN_HERE

# Required for manager accounts only: Specify the login customer ID used to
# authenticate API calls. This will be the customer ID of the authenticated
# manager account. You can also specify this later in code if your application
# uses multiple manager account + OAuth pairs.
#
# login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE