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 ambiente de desenvolvimento integrado (IDE) de sua preferência. Nossos artefatos são publicados no repositório Maven central.
Recomendamos o uso da lista de materiais (BOM, na sigla em inglês) da API Google Ads para gerenciar versões de dependência.
Também é possível criar a partir da origem. Para fins deste guia, presumimos que você tenha uma configuração de projeto com as dependências necessárias disponíveis.
Se você estiver criando a partir da origem, 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 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, vamos executar o GetCampaigns exemplo.
Primeiro, navegue até o diretório google-ads-examples.
cd google-ads-examples
Esse exemplo exige um parâmetro --customerId em que o valor é o ID do 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"
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 INSERT_XXXXX_HERE no código-fonte. Para conferir 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'