Participe da nossa transmissão ao vivo no Discord no servidor da comunidade de publicidade e medição do Google e no YouTube em 15 de outubro, às 11h (horário de Brasília). Vamos falar sobre os novos recursos adicionados na versão 26 da API Google Ads.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Uso básico

O uso básico da biblioteca de cliente Java é o seguinte:

Criar um novo projeto do Maven ou Gradle

Crie um novo projeto do Maven ou Gradle no IDE de sua preferência. Os artefatos são publicados no repositório central Maven.

Use a lista de materiais (BOM, na sigla em inglês) da API Google Ads para gerenciar versões de dependência.

Se você quiser executar os exemplos de código pré-empacotados incluídos no google-ads-examples módulo, clone o google-ads-java repositório do GitHub ou crie a partir da origem. Se você estiver criando a partir da origem, ative o processamento de anotações no seu IDE.

Configurar o acesso à API

Para se conectar à API Google Ads, você precisa fornecer credenciais de autenticação e autorização. Consulte o guia de autenticação e autorização para mais detalhes sobre as credenciais necessárias e como configurar a biblioteca de cliente.

Fazer sua primeira chamada

Depois de configurar suas credenciais, você estará pronto para fazer sua primeira chamada de API.

Para validar suas credenciais e fazer sua primeira chamada usando o repositório clonado google-ads-java, execute o exemplo GetCampaigns.

Primeiro, navegue até o diretório google-ads-examples:

cd google-ads-examples

Este exemplo exige um parâmetro --customerId em que o valor é o ID de cliente da sua conta do Google Ads sem hifens (-).

Para executar com o Gradle:

./gradlew -q runExample \
  --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"

Para executar com o Maven:

mvn exec:java \
  -Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
  -Dexec.args="--customerId INSERT_CUSTOMER_ID_HERE"

Conferir outros exemplos

O pacote de exemplos em google-ads-examples contém vários exemplos úteis. A maioria dos exemplos exige parâmetros. Você pode transmitir os parâmetros como argumentos (recomendado) ou editar os valores do marcador INSERT_..._HERE no código-fonte. Para conferir uma declaração de uso de um exemplo, transmita --help como o único argumento.

Com o Gradle:

./gradlew -q runExample --example="basicoperations.GetCampaigns --help"

Você também pode usar a tarefa listExamples no Gradle para listar todos os exemplos, exemplos em um subdiretório ou exemplos em que a descrição inclui um termo de pesquisa:

# List all examples:
./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
./gradlew -q listExamples --searchTerm='Performance Max'