Esta página foi traduzida pela API Cloud Translation.

A biblioteca de cliente Perl

A biblioteca de cliente Perl está hospedada no GitHub, e o pacote está disponível no CPAN.

A biblioteca é compatível com o Perl versão 5.28.1 ou mais recente.

Protocolo da API REST

As entidades de classe, como serviço, recurso, enumeração e erro, na biblioteca de cliente Perl são geradas analisando as definições de buffer de protocolo. Para saber mais sobre como os dados estruturados são serializados, consulte a documentação do buffer de protocolo.

Para se conectar à API Google Ads, a biblioteca de cliente cria uma solicitação HTTP em JSON, envia para o endpoint REST por HTTP 1.1, desserializa a resposta como um objeto JSON e interpreta os resultados.

Instalar a biblioteca

A biblioteca de cliente Perl está hospedada no GitHub e é distribuída usando o CPAN.

Clone a biblioteca do GitHub:

git clone https://github.com/googleads/google-ads-perl.git

Mude para o diretório google-ads-perl:
```
cd google-ads-perl
```
Você vai encontrar alguns arquivos e subdiretórios:
- Build.PL: o arquivo de build do Perl, que contém as dependências e os tipos de teste deste projeto.
- lib: código-fonte da biblioteca.
- t: casos de teste do código da biblioteca.
- examples: muitos exemplos que demonstram como usar a biblioteca para executar casos de uso comuns usando a API Google Ads.
- googleads.properties: o arquivo de configuração de amostra da biblioteca.
- log4perl.conf: o arquivo de configuração de geração de registros de amostra.
Instale as dependências necessárias. O arquivo Build.PL lista todas as dependências necessárias para a biblioteca. Para instalar, execute os seguintes comandos:
```
cpan install Module::Build
perl Build.PL
perl Build installdeps
```

Fazer sua primeira chamada de API

Para usar a API Google Ads, você precisa seguir várias etapas para acessar a API e configurar suas contas do Google Ads. Recomendamos seguir 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 mais sobre como usar a biblioteca de cliente Perl.

Autenticação e autorização

A biblioteca de cliente Perl oferece suporte a várias abordagens de autenticação e autorização. Consulte o guia Autenticação e autorização para saber mais.

Configuração e geração de registros

A biblioteca de cliente do Perl usa googleads.properties para configuração e log4perl.conf para geração de registros. É possível modificar esses arquivos para personalizar o comportamento da biblioteca. Consulte o guia do Logging para saber mais.

Utilitários

A biblioteca de cliente Perl inclui algumas classes utilitárias para melhorar a usabilidade da API. Consulte os guias a seguir para saber mais:

Ajustar o desempenho do aplicativo

Consulte o guia de performance para recomendações sobre como ajustar o desempenho do seu aplicativo.