A biblioteca de cliente Perl

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

A biblioteca oferece suporte ao Perl versão 5.28.1 ou mais recente.

Protocolo da API REST

Observação: a API Google Ads expõe endpoints REST JSON padrão e uma interface gRPC de alta performance. Como o Perl não é uma linguagem compatível na pilha gRPC, essa biblioteca de cliente é implementada no protocolo JSON REST sobre HTTP 1.1.

As entidades de classe, como serviço, recurso, tipo enumerado e erro, na biblioteca de cliente do PERL são geradas pela análise das 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 sobre HTTP 1.1, desserializa a resposta como um objeto JSON e interpreta os resultados.

Instalar a biblioteca

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

1. Clone a biblioteca do GitHub:

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

2. Mude para o diretório google-ads-perl:

   cd google-ads-perl
   

   Você verá alguns arquivos e subdiretórios:

   • Build.PL: o arquivo de build do Perl, que contém as dependências e os tipos de teste desse 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 registro de amostra.

3. Instale as dependências necessárias e crie a biblioteca. O arquivo Build.PL lista todas as dependências necessárias para a biblioteca. Para instalá-las, execute os seguintes comandos:

   cpan install Module::Build
   perl Build.PL
   ./Build installdeps
   ./Build
   ./Build install
   

Observação: Cada versão do Google::Ads::GoogleAds::Client agrupa módulos específicos da versão da API Google Ads em lib/Google/Ads/GoogleAds/, em que versões secundárias da API, como v25.1, são incluídas no módulo da versão principal, V25. Consulte a tabela de versões da API com suporte para saber mais sobre a compatibilidade de versões.

Fazer sua primeira chamada de API

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 orienta você em 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 do Perl.

Autenticação e autorização

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

Configuração e registro

A biblioteca de cliente do Perl usa googleads.properties para configuração e log4perl.conf para registro. Você pode modificar esses arquivos para personalizar o comportamento da biblioteca. Consulte os guias de configuração e registro para saber mais.

Utilitários

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

• Máscaras de campo
• Nomes de recursos

Ajustar a performance do aplicativo

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