La biblioteca cliente de Perl

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

La biblioteca admite la versión 5.28.1 o posterior de Perl.

Protocolo de la API de REST

Nota: La API de Google Ads expone extremos REST de JSON estándar y una interfaz gRPC de alto rendimiento. Dado que Perl no es un lenguaje compatible en la pila de gRPC, esta biblioteca cliente se implementa en el protocolo REST de JSON a través de HTTP 1.1.

Las entidades de clase, como servicio, recurso, enumeración y error, en la biblioteca cliente de Perl se generan analizando 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 de búferes de protocolo.

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

Cómo instalar la biblioteca

La biblioteca cliente de Perl está alojada en GitHub y se distribuye a través de 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 pruebas de este proyecto.
   • lib: Código fuente de la biblioteca.
   • t: Casos de prueba del código de la biblioteca
   • examples: Muchos ejemplos que demuestran 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 enumera todas las dependencias requeridas para la biblioteca. Puedes instalarlos con los siguientes comandos:

   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 seguir varios pasos para obtener acceso a ella 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. Para obtener más información, consulta la guía de registro.

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:

• Máscaras de campo
• Nombres de recursos

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.