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

Klassenentitäten wie Dienst, Ressource, Enum und Fehler in der Perl-Clientbibliothek werden durch das Parsen der Protocol Buffer Definitionen generiert. Weitere Informationen zum Serialisieren strukturierter Daten finden Sie in der protocol buffer-Dokumentation.

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 von GitHub:

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

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

    cd google-ads-perl

    Sie 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: Testfälle 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 Nutzung.

Authentifizierung und Autorisierung

Die Perl-Clientbibliothek unterstützt mehrere Ansätze für die Authentifizierung und Autorisierung. Weitere Informationen finden Sie im Leitfaden zur Authentifizierung und Autorisierung.

Konfiguration und Logging

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

Dienstprogramme

Die Perl-Clientbibliothek enthält einige Dienstprogrammklassen, um die API-Nutzung zu verbessern. Weitere Informationen finden Sie in den folgenden Leitfäden:

Anwendungsleistung optimieren

Empfehlungen zur Optimierung der Anwendungsleistung finden Sie im Leitfaden zur Leistung.