Bibliotecas de cliente

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Nossas bibliotecas de cliente oferecem visualizações de alto nível e elementos básicos da funcionalidade da API Google Ads, facilitando o desenvolvimento rápido de apps. 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 Maven, tar.gz Ver no GitHub
.NET google-ads-xxxxxx tar.gz, zip (link em inglês) Ver no GitHub
PHP google-ads-php tar.gz (em inglês) Ver no GitHub
Python google-ads-python tar.gz, zip (link 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 (link em inglês) Ver no GitHub

Versões compatíveis da API

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

Java

API e versões Java mínima/máxima compatíveis
v12 Min: 22,0.0
Max: -
v11 Min: 19.0.0
Max: -
v10 Min: 17.0.0
Max: -

C#

API e versões mínimas/máximas do .NET
v12 Min: 14.2.0
Max: -
v11 Min: 12.1.0
Max: -
v10 Min: 11.0.0
Max::

PHP

API e versões compatíveis de Min/Max de PHP
v12 Min: 17.1.0
Max: -
v11 Min: 15.1.0
Max: -
v10 Min: 14.0.0
Max::

Python

API e versões mínimas/máximas do Python
v12 Min: 19.0.0
Max: -
v11 Min: 17.0.0
Max: -
v10 Min: 15.0.0
Max: -

Ruby

API e versões compatíveis do mínimo e máximo do Ruby
v12 Min: 20.0.0
Max: -
v11 Min: 18.0.0
Max: -
v10 Min: 16.0.0
Max: -

Perl

API e versões compatíveis de Min/Max Perl
v12 Min: 14.0.0
Max::
v11 Min: 12.0.0
Max: -
v10 Min: 10.0.0
Max: -

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 dela.

Veja 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 sua 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. Essa 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ê está representando.
  • API Google Ads
    • GOOGLE_ADS_DEVELOPER_TOKEN: defina como o token do 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 autorizados por meio de 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 precisa ser definido sem hifens (-). Para saber mais sobre Contas vinculadas, visite a Central de Ajuda.