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

As entidades de classe, como serviço, recurso, enumeração 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 via 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 o 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ê 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 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. 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
perl Build installdeps

Fazer sua primeira chamada de API

Para usar a API Google Ads, é necessário realizar várias etapas para ter acesso a ela e configurar suas contas do Google Ads. Recomendamos seguir 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 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. É possível modificar esses arquivos para personalizar o comportamento da biblioteca. Consulte o guia de registro para saber mais.

Utilitários

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

Ajustar o desempenho do aplicativo

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