Die Perl-Clientbibliothek

Die Perl-Clientbibliothek wird auf GitHub gehostet und das Paket ist auf CPAN verfügbar.

Die Bibliothek unterstützt Perl-Versionen ab 5.28.1.

REST API-Protokoll

Klassenentitäten wie Dienst, Ressource, Enum und Fehler in der Perl-Clientbibliothek werden durch Parsen der Protokollzwischenspeicher-Definitionen generiert. Weitere Informationen zur Serialisierung strukturierter Daten finden Sie in der Dokumentation zu Protokollzwischenspeichern.

Um eine Verbindung mit der Google Ads API herzustellen, erstellt die Clientbibliothek eine HTTP-Anfrage im JSON-Format, 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.

Aus CPAN installieren

Installieren Sie die Google::Ads::GoogleAds::Client-Distribution direkt von CPAN mit cpanm (oder cpan):

cpanm Google::Ads::GoogleAds::Client

Aus Quelle erstellen und Beispiele ausführen

So führen Sie die gebündelten Codebeispiele aus oder erstellen die Bibliothek aus dem Quellcode:

  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 für gängige Anwendungsfälle mit der Google Ads API verwenden.
    • googleads.properties: die Beispielkonfigurationsdatei für die Bibliothek.
    • log4perl.conf: die Beispiel-Logging-Konfigurationsdatei.

  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

Initialisieren Sie Google::Ads::GoogleAds::Client (wodurch standardmäßig Anmeldedaten aus ~/googleads.properties oder GOOGLE_ADS_CONFIGURATION_FILE_PATH geladen werden) und streamen Sie Kampagnenzeilen mit SearchStreamHandler:

use strict;
use warnings;
use Google::Ads::GoogleAds::Client;
use Google::Ads::GoogleAds::Utils::SearchStreamHandler;
use Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest;

my $api_client = Google::Ads::GoogleAds::Client->new();
my $google_ads_service = $api_client->GoogleAdsService();

my $search_stream_request =
  Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
  ->new({
    customerId => "INSERT_CUSTOMER_ID_HERE",
    query      =>
      "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id"
  });

my $search_stream_handler =
  Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
    service => $google_ads_service,
    request => $search_stream_request
  });

$search_stream_handler->process_contents(
  sub {
    my $google_ads_row = shift;
    printf "Campaign with ID %d and name '%s' was found.\n",
      $google_ads_row->{campaign}{id},
      $google_ads_row->{campaign}{name};
  });

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 zur Authentifizierung und Autorisierung. Weitere Informationen finden Sie im Leitfaden 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 zu Konfiguration und Logging.

Dienstprogramme

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

Anwendungsleistung optimieren

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