O uso básico da biblioteca de cliente Java é o seguinte:
Crie um projeto Maven ou Gradle
Crie um projeto Maven ou Gradle no ambiente de desenvolvimento integrado de sua escolha. Nossos artefatos são publicados no repositório central do Maven.
Recomendamos usar a lista de materiais (BOM) da API Google Ads para gerenciar versões de dependência.
Também é possível criar do código-fonte. Para este guia, presumimos que você tenha um projeto configurado com as dependências necessárias disponíveis.
Se você estiver criando com base na origem, ative o processamento de anotações no 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 saber 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, vamos executar 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 traços.
Para executar com o Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --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 de INSERT_XXXXX_HERE no código-fonte. Para conferir uma declaração de uso
em 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'