Die Perl-Clientbibliothek wird auf GitHub gehostet und das Paket ist auf CPAN verfügbar.
Die Bibliothek unterstützt Perl-Version 5.28.1 oder höher.
REST API-Protokoll
Klassenentitäten wie Dienst, Ressource, Enum und Fehler in der Perl-Clientbibliothek werden durch Parsen der Protokollpufferdefinitionen generiert. Weitere Informationen zur Serialisierung strukturierter Daten finden Sie in der Dokumentation zu Protokollpuffern.
Um eine Verbindung zur Google Ads API herzustellen, erstellt die Clientbibliothek eine HTTP-Anfrage in JSON, sendet sie über HTTP 1.1 an den REST-Endpunkt, deserialisiert die Antwort als JSON-Objekt und interpretiert die Ergebnisse.
Bibliothek installieren
Die Perl-Clientbibliothek wird auf GitHub gehostet und über CPAN verteilt.
Klonen Sie die Bibliothek aus GitHub:
git clone https://github.com/googleads/google-ads-perl.gitWechseln Sie in das Verzeichnis
google-ads-perl:cd google-ads-perlSie sehen einige Dateien und Unterverzeichnisse:
Build.PL: Die Perl-Build-Datei, die die Abhängigkeiten und Testtypen dieses Projekts enthält.lib: Quellcode der Bibliothek.t: Testläufe des Bibliothekscodes.examples: Viele Beispiele, die zeigen, wie die Bibliothek verwendet werden kann, um häufige Anwendungsfälle mit der Google Ads API auszuführen.googleads.properties: die Beispielkonfigurationsdatei für die Bibliothek.log4perl.conf: die Beispielkonfigurationsdatei für das Logging.
Installieren Sie die erforderlichen Abhängigkeiten und erstellen Sie die Bibliothek. In der Datei
Build.PLsind alle für die Bibliothek erforderlichen Abhängigkeiten aufgeführt. Sie können sie mit den folgenden Befehlen installieren:cpan install Module::Build perl Build.PL ./Build installdeps ./Build ./Build install
Der erste API-Aufruf
Wenn Sie die Google Ads API verwenden möchten, müssen Sie mehrere Schritte ausführen, um Zugriff auf die API zu erhalten und Ihre Google Ads-Konten zu konfigurieren. Folgen Sie der Kurzanleitung, in der alle wichtigen Schritte beschrieben werden, einschließlich der Einrichtung Ihrer Google Ads-Konten.
Grundlegende Nutzung
Weitere Informationen zur Verwendung der Perl-Clientbibliothek finden Sie im Leitfaden zur grundlegenden Verwendung.
Authentifizierung und Autorisierung
Die Perl-Clientbibliothek unterstützt mehrere Ansätze für die Authentifizierung und Autorisierung. Weitere Informationen finden Sie im Leitfaden Authentifizierung und Autorisierung.
Konfiguration und Logging
In der Perl-Clientbibliothek wird googleads.properties für die Konfiguration und log4perl.conf für die Protokollierung verwendet. Sie können diese Dateien ändern, um das Verhalten der Bibliothek anzupassen. Weitere Informationen finden Sie in den Leitfäden Konfiguration und Logging.
Dienstprogramme
Die Perl-Clientbibliothek enthält Hilfsklassen, die die API-Nutzung vereinfachen. Weitere Informationen finden Sie in den folgenden Anleitungen:
Anwendungsleistung optimieren
Im Leistungsleitfaden finden Sie Empfehlungen zur Optimierung der Anwendungsleistung.