Bibliotecas de cliente

Nossas bibliotecas cliente oferecem vistas de alto nível e elementos básicos da funcionalidade da API Google Ads, facilitando o desenvolvimento rápido de aplicativos. Recomendamos começar com uma se você for novo na API.

Biblioteca de cliente Origem Distribuição Exemplos de código
Java google-ads-java Maven, tar.gz Ver no GitHub
.NET google-ads-Agora tar.gz, zip. Ver no GitHub
PHP google-ads-php tar.gz; Ver no GitHub
Python google-ads-python tar.gz, zip. Ver no GitHub
Ruby google-ads-ruby (em inglês) gem, tar.gz, zip Ver no GitHub
Perl (em inglês) google-ads-perl tar.gz, zip. Ver no GitHub

Versões da API compatíveis

A tabela abaixo lista as versões de biblioteca específicas compatíveis com cada versão de API disponível.

Versão da API Versão da biblioteca Python Versão da biblioteca Ruby Versão da biblioteca PHP Versão da biblioteca Java Versão da biblioteca .NET Versão da biblioteca Perl
v11 >= 17,0.0 >= 18.0.0 >=15,1.0 >= 19,0,0 >= 12.1.0 >= 12.0.0
v10 >= 15,0,0 >= 16.0.0 >= 14,0.0 >= 17,0.0 >= 11.0.0 >= 10,0,0
Versão 9 >= 14,1.0 >= 15,0,0 >= 12.1.0 >= 16.0.0 >= 10,2.0 >= 9.2.0

Configuração

Cada biblioteca de cliente da API Ads fornece diferentes configurações e métodos de carregamento que podem ser usados para personalizar o comportamento.

Estas são as variáveis de ambiente comuns a todas as bibliotecas de cliente que podem ser carregadas para definir as configurações:

  • Biblioteca de cliente
    • GOOGLE_ADS_CONFIGURATION_FILE_PATH: caminho para o arquivo de configuração.
  • OAuth2
    • Modo de aplicativo
      • GOOGLE_ADS_CLIENT_ID : defina esse valor como seu ID do cliente OAuth2.
      • GOOGLE_ADS_CLIENT_SECRET: defina esse valor como a chave secreta do cliente do OAuth2.
      • GOOGLE_ADS_REFRESH_TOKEN : defina esse valor como um token de atualização OAuth2 gerado previamente se quiser reutilizar tokens OAuth2. Esta configuração é opcional.
    • Modo de conta de serviço
      • GOOGLE_ADS_JSON_KEY_FILE_PATH: defina esse valor como o caminho do arquivo de configuração JSON do OAuth2.
      • GOOGLE_ADS_IMPERSONATED_EMAIL: defina esse valor como o endereço de e-mail da conta que você representa.
  • API Google Ads
    • GOOGLE_ADS_DEVELOPER_TOKEN: defina como o token de desenvolvedor.
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID: este é o ID do cliente autorizado a ser usado na solicitação, sem hifens (-).
    • GOOGLE_ADS_LINKED_CUSTOMER_ID : esse cabeçalho só é necessário para métodos que atualizam os recursos de uma entidade quando permitido pelas contas vinculadas na IU do Google Ads (recurso AccountLink na API Google Ads). Defina esse valor como o ID de cliente do provedor de dados que atualiza os recursos dele. Ele deve ser definido sem hifens (-). Para saber mais sobre contas vinculadas, acesse a Central de Ajuda.