Uso básico

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

Criar um projeto do Maven ou do Gradle

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

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

Se você 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 usando o código-fonte. Se você estiver criando com base na origem, verifique se o processamento de anotações está ativado no ambiente de desenvolvimento integrado.

Configurar o acesso à API

Para se conectar à API Google Ads, é preciso 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 requer 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"

Confira outros exemplos

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

Com o Gradle:

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

Também é possível 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'