Cette page a été traduite par l'API Cloud Translation.

Bibliothèque cliente Perl

La bibliothèque cliente Perl est hébergée sur GitHub et le package est disponible sur CPAN.

La bibliothèque est compatible avec Perl version 5.28.1 ou ultérieure.

Protocole de l'API REST

Les entités de classe (comme les services, les ressources, les énumérations et les erreurs) de la bibliothèque cliente Perl sont générées en analysant les définitions de tampon de protocole. Pour en savoir plus sur la sérialisation des données structurées, consultez la documentation sur les tampons de protocole.

Pour se connecter à l'API Google Ads, la bibliothèque cliente crée une requête HTTP au format JSON, l'envoie au point de terminaison REST via HTTP 1.1, désérialise la réponse en tant qu'objet JSON et interprète les résultats.

Installer la bibliothèque

La bibliothèque cliente Perl est hébergée sur GitHub et distribuée à l'aide de CPAN.

Clonez la bibliothèque depuis GitHub :

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

Accédez donc à ce répertoire google-ads-perl :
```
cd google-ads-perl
```
Vous verrez des fichiers et des sous-répertoires :
- Build.PL : fichier de compilation Perl, qui contient les dépendances et les types de tests de ce projet.
- lib : code source de la bibliothèque.
- t : cas de test du code de la bibliothèque.
- examples : de nombreux exemples illustrant l'utilisation de la bibliothèque pour exécuter des cas d'utilisation courants à l'aide de l'API Google Ads.
- googleads.properties : fichier de configuration exemple pour la bibliothèque.
- log4perl.conf : exemple de fichier de configuration de la journalisation.
Installez les dépendances requises. Le fichier Build.PL répertorie toutes les dépendances requises pour la bibliothèque. Vous pouvez les installer en exécutant les commandes suivantes :
```
cpan install Module::Build
perl Build.PL
perl Build installdeps
```

Effectuer votre premier appel d'API

Pour utiliser l'API Google Ads, vous devez suivre plusieurs étapes pour y accéder et configurer vos comptes Google Ads. Nous vous recommandons de suivre le guide de démarrage rapide, qui vous guidera à travers toutes les étapes importantes, y compris la configuration de vos comptes Google Ads.

Utilisation de base

Consultez le guide d'utilisation de base pour en savoir plus sur l'utilisation de la bibliothèque cliente Perl.

Authentification et autorisation

La bibliothèque cliente Perl est compatible avec plusieurs approches d'authentification et d'autorisation. Pour en savoir plus, consultez le guide Authentification et autorisation.

Configuration et journalisation

La bibliothèque cliente Perl utilise googleads.properties pour la configuration et log4perl.conf pour la journalisation. Vous pouvez modifier ces fichiers pour personnaliser le comportement de la bibliothèque. Pour en savoir plus, consultez le guide Journalisation.

Utilitaires

La bibliothèque cliente Perl inclut quelques classes utilitaires pour améliorer la facilité d'utilisation de l'API. Pour en savoir plus, consultez les guides suivants :

Affiner les performances de votre application

Consultez le guide des performances pour obtenir des recommandations sur la façon d'affiner les performances de votre application.