Bibliotecas de cliente

Nossas bibliotecas cliente fornecem visualizações de alto nível e elementos básicos da funcionalidade da Google Ads API, facilitando o desenvolvimento rápido de aplicativos. Recomendamos começar com uma se você não tiver experiência com a API.

Biblioteca de cliente Fonte Distribuição Exemplos de código
Java google-ads-java (em inglês) Maven, tar.gz Ver no GitHub
.NET google-ads-dotnet nuget, tar.gz, zip Ver no GitHub
PHP google-ads-php. tar.gz (em inglês) Ver no GitHub
Python google-ads-python. tar.gz, zip (em inglês) 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 (em inglês) Ver no GitHub

Versões compatíveis da API

A tabela mostra quais bibliotecas de cliente funcionam com quais versões de API.

Java

Biblioteca de cliente para Java
v13 Min: 23.0.0
Max: -
v12 Min: 22.0.0
Max: -

C#

Biblioteca de cliente para .NET
v13 Min: 15.0.0
Max: -
v12 Min: 14.2.0
Max: -

PHP

Biblioteca de cliente para PHP
v13 Min: 18.0.0
Max: -
v12 Min: 17.1.0
Max: -

Python

Biblioteca de cliente para Python
v13 Min: 20.0.0
Max: -
v12 Min: 19.0.0
Max: -

Ruby

Biblioteca de cliente para Ruby
v13 Min: 21.0.0
Max: -
v12 Min: 20.0.0
Max: -

Perl

Biblioteca de cliente para Perl
v13 Min: 15.0.0
Max: -
v12 Min: 14.0.0
Max: -

Configuração

Cada biblioteca cliente da Google Ads API fornece diferentes configurações e métodos de carregamento que você pode usar para personalizar seu comportamento.

Veja as variáveis de ambiente comuns a todas as bibliotecas de cliente e 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 OAuth2.
      • GOOGLE_ADS_REFRESH_TOKEN : defina esse valor como um token de atualização OAuth2 pré-gerado 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 com seu 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 : este cabeçalho é necessário somente para métodos que atualizam os recursos de uma entidade quando permitido pelas contas vinculadas na IU do Google Ads (recurso AccountLink na Google Ads API). Defina esse valor como o ID de cliente do provedor de dados que atualiza os recursos do ID de cliente especificado. Ele precisa ser definido sem hifens (-). Para saber mais sobre contas vinculadas, acesse a Central de Ajuda.