La biblioteca cliente de Perl

La biblioteca cliente de Perl está alojada en GitHub y el paquete está disponible en CPAN.

La biblioteca admite Perl versión 5.28.1 o posterior.

Protocolo de la API de REST

Las entidades de clase, como el servicio, el recurso, la enumeración y el error, en la biblioteca cliente de Perl se generan mediante el análisis de las definiciones de búfer de protocolo. Para obtener más información sobre cómo se serializan los datos estructurados, consulta la documentación sobre búferes de protocol protocolo.

Para conectarse con la API de Google Ads, la biblioteca cliente crea una solicitud HTTP en JSON, la envía al extremo REST a través de HTTP 1.1, deserializa la respuesta como un objeto JSON y analiza los resultados.

Cómo instalar la biblioteca

La biblioteca cliente de Perl está alojada en GitHub y se distribuye con CPAN.

  1. Clona la biblioteca desde GitHub:

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

  2. Cambia al directorio google-ads-perl con el siguiente comando:

    cd google-ads-perl

    Verás algunos archivos y subdirectorios:

    • Build.PL: Es el archivo de compilación de Perl, que contiene las dependencias y los tipos de prueba de este proyecto.
    • lib: Es el código fuente de la biblioteca.
    • t: Son los casos de prueba del código de la biblioteca.
    • examples: Son muchos ejemplos que muestran cómo usar la biblioteca para ejecutar casos de uso comunes con la API de Google Ads.
    • googleads.properties: Es el archivo de configuración de muestra para la biblioteca.
    • log4perl.conf: Es el archivo de configuración de registro de muestra.

  3. Instala las dependencias requeridas. El archivo Build.PL muestra todas las dependencias necesarias para la biblioteca. Puedes ejecutar los siguientes comandos para instalarlos:

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

Realiza tu primera llamada a la API

Para usar la API de Google Ads, debes realizar varios pasos para obtener acceso a la API y configurar tus cuentas de Google Ads. Te recomendamos que sigas la guía de inicio rápido, que te guiará por todos los pasos importantes, incluida la configuración de tus cuentas de Google Ads.

Uso básico

Consulta la guía de uso básico para obtener más información sobre cómo usar la biblioteca cliente de Perl.

Autenticación y autorización

La biblioteca cliente de Perl admite varios enfoques para la autenticación y la autorización. Consulta la guía de autenticación y autorización para obtener más información.

Configuración y registro

La biblioteca cliente de Perl usa googleads.properties para la configuración y log4perl.conf para el registro. Puedes modificar estos archivos para personalizar el comportamiento de la biblioteca. Consulta la guía de registro para obtener más información.

Utilidades

La biblioteca cliente de Perl incluye algunas clases de utilidad para mejorar la usabilidad de la API. Consulta las siguientes guías para obtener más información:

Ajusta el rendimiento de tu aplicación

Consulta la guía de rendimiento para obtener recomendaciones sobre cómo ajustar el rendimiento de tu aplicación.