A biblioteca de cliente para Java é hospedada no GitHub e distribuída pelo Maven Central. Ela oferece vários recursos para ajudar você a usar a API, incluindo gerenciamento mais fácil de credenciais e criação de clientes de serviço da API Google Ads.
A biblioteca requer o Java 8 ou uma versão mais recente.
Instalação
Use a lista de materiais (BOM) da API Google Ads no arquivo pom.xml ou
build.gradle para gerenciar 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>46.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 da fonte.
Fazer sua primeira chamada de API
Biblioteca de vídeos: como começar a usar a biblioteca de cliente Java
Para usar a API Google Ads, você precisa realizar várias etapas para acessar a API e configurar suas contas do Google Ads. Siga o guia de início rápido, que explica 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 oferece suporte a várias abordagens de autenticação e autorização, incluindo fluxos de aplicativos da Web e de 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 oferece várias opções de configuração (incluindo arquivos ads.properties, variáveis de ambiente e configuração programática) e recursos de registro 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: ajudantes para construir 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: ajudantes para monitorar e gerenciar operações assíncronas de API.
Ajuste seu aplicativo
Consulte o guia de uso avançado para recomendações sobre como ajustar os tempos limite, as configurações de repetição, a latência de inicialização e o gerenciamento de dependências do aplicativo.