Biblioteka klienta Perl

Biblioteka klienta Perl jest hostowana na GitHub, a pakiet jest dostępny w CPAN.

Biblioteka obsługuje Perla w wersji 5.28.1 lub nowszej.

Protokół API typu REST

Encje klas – takie jak usługa, zasób, typ wyliczeniowy i błąd – w bibliotece klienta Perl są generowane przez analizowanie definicji buforów protokołu. Więcej informacji o serializacji uporządkowanych danych znajdziesz w dokumentacji bufora protokołu.

Aby połączyć się z interfejsem Google Ads API, biblioteka klienta tworzy żądanie HTTP w formacie JSON, wysyła je do punktu końcowego REST przez HTTP 1.1, deserializuje odpowiedź jako obiekt JSON i interpretuje wyniki.

Instalowanie biblioteki

Biblioteka klienta Perl jest hostowana na GitHub i rozpowszechniana za pomocą CPAN.

Instalowanie z CPAN

Zainstaluj dystrybucję Google::Ads::GoogleAds::Client bezpośrednio z CPAN za pomocą cpanm (lub cpan):

cpanm Google::Ads::GoogleAds::Client

Kompilowanie ze źródła i uruchamianie przykładów

Aby uruchomić przykłady kodu dołączone do pakietu lub utworzyć bibliotekę z kodu źródłowego:

  1. Sklonuj bibliotekę z GitHuba:

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

  2. Przejdź do katalogu google-ads-perl:

    cd google-ads-perl

    Zobaczysz kilka plików i podkatalogów:

    • Build.PL: plik kompilacji Perla, który zawiera zależności i typy testów tego projektu.
    • lib: kod źródłowy biblioteki.
    • t: elementy testowania kodu biblioteki.
    • examples: wiele przykładów pokazujących, jak używać biblioteki do wykonywania typowych zadań za pomocą interfejsu Google Ads API.
    • googleads.properties: przykładowy plik konfiguracji biblioteki.
    • log4perl.conf: przykładowy plik konfiguracji logowania.

  3. Zainstaluj wymagane zależności i utwórz bibliotekę. Plik Build.PL zawiera listę wszystkich zależności wymaganych przez bibliotekę. Możesz je zainstalować, uruchamiając te polecenia:

    cpan install Module::Build
perl Build.PL
./Build installdeps
./Build
./Build install

Wykonaj pierwsze wywołanie interfejsu API

Aby korzystać z interfejsu Google Ads API, musisz wykonać kilka czynności, które pozwolą Ci uzyskać dostęp do interfejsu API i skonfigurować konta Google Ads. Postępuj zgodnie z krótkim przewodnikiem, który przeprowadzi Cię przez wszystkie ważne kroki, w tym konfigurowanie kont Google Ads.

Podstawowe użycie

Zainicjuj Google::Ads::GoogleAds::Client (który domyślnie wczytuje dane logowania z ~/googleads.properties lub GOOGLE_ADS_CONFIGURATION_FILE_PATH) i przesyłaj strumieniowo wiersze kampanii za pomocą 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};
  });

Więcej informacji o korzystaniu z biblioteki klienta Perl znajdziesz w podstawowym przewodniku.

Uwierzytelnianie i autoryzacja

Biblioteka klienta Perl obsługuje wiele metod uwierzytelniania i autoryzacji. Więcej informacji znajdziesz w przewodniku Uwierzytelnianie i autoryzacja.

Konfiguracja i logowanie

Biblioteka klienta Perl używa googleads.properties do konfiguracji i log4perl.conf do logowania. Możesz zmodyfikować te pliki, aby dostosować działanie biblioteki. Więcej informacji znajdziesz w przewodnikach dotyczących konfiguracji i logowania.

Narzędzia

Biblioteka klienta Perl zawiera klasy narzędziowe, które ułatwiają korzystanie z interfejsu API. Aby dowiedzieć się więcej, zapoznaj się z tymi przewodnikami:

Dostosowywanie wydajności aplikacji

Wskazówki dotyczące dostrajania wydajności aplikacji znajdziesz w przewodniku po wydajności.