Perl-Client-Bibliothek

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

Hinweis :Die Google Ads API bietet sowohl standardmäßige JSON REST-Endpunkte als auch eine leistungsstarke gRPC-Schnittstelle. Da Perl im gRPC-Stack nicht unterstützt wird, ist diese Clientbibliothek auf dem JSON-REST-Protokoll über HTTP 1.1 implementiert.

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 Protokollzwischenspeichern.

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.

1. Klonen Sie die Bibliothek aus GitHub:

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

2. Wechseln Sie in das Verzeichnis google-ads-perl:

   cd google-ads-perl
   

   Es werden einige Dateien und Unterverzeichnisse angezeigt:

   • 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 Sie die Bibliothek verwenden, 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.

3. Installieren Sie die erforderlichen Abhängigkeiten. In der Datei Build.PL sind 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
   perl Build installdeps
   

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. Wir empfehlen Ihnen, der Kurzanleitung zu folgen, 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 in der Anleitung zur Authentifizierung und Autorisierung.

Konfiguration und Logging

Die Perl-Clientbibliothek verwendet googleads.properties für die Konfiguration und log4perl.conf für die Protokollierung. Sie können diese Dateien ändern, um das Verhalten der Bibliothek anzupassen. Weitere Informationen finden Sie im Leitfaden Logging.

Dienstprogramme

Die Perl-Clientbibliothek enthält einige Hilfsklassen, die die API-Nutzerfreundlichkeit verbessern. Weitere Informationen finden Sie in den folgenden Leitfäden:

• Feldmasken
• Ressourcennamen

Anwendungsleistung optimieren

Empfehlungen zur Optimierung der Anwendungsleistung finden Sie im Leistungsleitfaden.