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 o 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, na sigla em inglês) 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.0.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 de origem.
Fazer sua primeira chamada de API
Para usar a API Google Ads, você precisa realizar várias etapas para ter acesso a ela e configurar suas contas do Google Ads. Siga o guia de início rápido, que orienta você em todas as etapas importantes, incluindo a configuração das 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 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 registro
A biblioteca de cliente Java oferece suporte a 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 de utilitários 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 da API.
Ajustar seu aplicativo
Consulte o guia de uso avançado para conferir 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 seu aplicativo.