A biblioteca de cliente para Java está hospedada no GitHub e é distribuída pelo Maven Central. Ela oferece vários recursos para ajudar você a usar a API, incluindo um gerenciamento mais fácil de credenciais e a criação de clientes de serviço da API Google Ads.
A biblioteca requer o Java 8 ou mais recente.
Instalação
Use a lista de materiais (BOM) da API Google Ads no arquivo pom.xml ou
build.gradle para gerenciar as versões de dependência:
<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
versions of all google-ads libraries. -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads-bom</artifactId>
<version>48.1.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<!-- Add the google-ads dependency, without a version. The version is
managed by the BOM. -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
</dependency>
Também é possível criar a biblioteca usando o código-fonte.
Fazer sua primeira chamada de API
Para usar a API Google Ads, você precisa seguir várias etapas para ter acesso à API e configurar suas contas do Google Ads. Siga o guia de início rápido, que mostra todas as etapas importantes, incluindo a configuração das suas contas do Google Ads.
Uso básico
Consulte o guia de uso básico para saber como configurar um projeto, instanciar clientes de serviço e executar exemplos de código com a biblioteca de cliente Java.
Autenticação e autorização
A biblioteca de cliente Java é compatível com várias abordagens de autenticação e autorização, incluindo fluxos de aplicativos da Web e para computador do OAuth 2.0, contas de serviço e Application Default Credentials. Consulte o guia de autenticação e autorização para saber mais.
Configuração e geração de registros
A biblioteca de cliente Java é compatível com várias opções de configuração
(incluindo arquivos ads.properties, variáveis de ambiente e configuração
programática) e recursos de geração de registros para rastrear solicitações e respostas
da API.
Utilitários
A biblioteca de cliente Java inclui classes utilitárias para melhorar a usabilidade da API. Consulte os guias a seguir para saber mais:
- FieldMasks: auxiliares para criar e calcular máscaras de campo de atualização.
- ResourceNames: utilitários para formatar strings de nome de recurso de entidade.
- Operações de longa duração: auxiliares para monitorar e gerenciar operações de API assíncronas.
Ajustar o aplicativo
Consulte o guia de uso avançado para recomendações sobre como ajustar os tempos limite, as configurações de nova tentativa, a latência de inicialização e o gerenciamento de dependências do aplicativo.