Uso básico

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

Criar um projeto do Maven ou Gradle

Crie um projeto do Maven ou Gradle no ambiente de desenvolvimento integrado de sua escolha. Os artefatos são publicados no repositório Maven Central.

Use a lista de materiais (BOM) da API Google Ads para gerenciar versões de dependência.

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

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 detalhes sobre as credenciais necessárias e como configurar a biblioteca de cliente.

Faça 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 google-ads-java clonado, 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"

Conheça outros exemplos

O pacote examples 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 de posição 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'