Die Perl-Clientbibliothek

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 zur Serialisierung 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 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
    

    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 können, 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 und erstellen Sie die Bibliothek. 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
    ./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 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 in den Leitfäden zur Konfiguration und zum Logging.

Dienstprogramme

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

Anwendungsleistung optimieren

Im Leistungsleitfaden finden Sie Empfehlungen zur Optimierung der Leistung Ihrer Anwendung.