Instalar a biblioteca de cliente do Python
Para instalar a biblioteca de cliente do Python no ambiente local:
- Extraia o tarball da biblioteca de cliente do Python.
Execute o seguinte comando no mesmo diretório:
python -m pip install .
Siga as instruções no terminal para concluir a instalação.
Configuração usando o arquivo YAML
É possível especificar um arquivo YAML para usar ao inicializar o cliente que contém
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 o segredo do cliente.
Para especificar o local em que o arquivo search-ads-360.yaml
está localizado, é possível
transmitir 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 fornecer 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 seguintes campos.
Campos gerais:
refresh_token
: seu token de atualização OAuth.client_id
: seu ID do cliente OAuth.client_secret
: sua chave secreta do cliente OAuth.login_customer_id
: consulte a documentação sobre o ID de login do cliente.
Chaves compatíveis para fluxos de aplicativos da Web e para computador
Se você estiver usando o fluxo de aplicativo para computador ou Web, as chaves compatíveis sã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