Biblioteka klienta Perl

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

Biblioteka obsługuje Perla w wersji 5.28.1 lub nowszej.

Protokół REST API

Uwaga: interfejs Google Ads API udostępnia zarówno standardowe punkty końcowe JSON REST, jak i interfejs gRPC o wysokiej wydajności. Ponieważ Perl nie jest obsługiwanym językiem w stosie gRPC, ta biblioteka klienta jest zaimplementowana w protokole JSON REST przez HTTP 1.1.

Jednostki klasowe, takie jak usługa, zasób, wyliczenie i błąd, w bibliotece klienta w Perlu są generowane przez analizowanie definicji bufora protokołu. Więcej informacji o tym, jak serializowane są uporządkowane dane, 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 w Perlu jest hostowana na GitHub i rozpowszechniana za pomocą CPAN.

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 przypadków użycia za pomocą interfejsu Google Ads API.
   • googleads.properties: przykładowy plik konfiguracyjny biblioteki.
   • log4perl.conf: przykładowy plik konfiguracyjny logowania.

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

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

Uwaga: każda wersja Google::Ads::GoogleAds::Client zawiera moduły określonej wersji interfejsu Google Ads API w katalogu lib/Google/Ads/GoogleAds/ (gdzie pomniejsze wersje interfejsu API, takie jak v25.1, są uwzględniane w module głównej wersji, V25). Zgodność wersji znajdziesz w tabeli obsługiwanych wersji interfejsu API.

Wykonywanie pierwszego wywołania interfejsu API

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

Podstawowe użycie

Więcej informacji o tym, jak korzystać z biblioteki klienta w Perlu, znajdziesz w przewodniku podstawowego użycia.

Uwierzytelnianie i autoryzacja

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

Konfiguracja i logowanie

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

Narzędzia

Biblioteka klienta w Perlu zawiera klasy narzędziowe, które ułatwiają korzystanie z interfejsu API. Więcej informacji znajdziesz w tych przewodnikach:

• Maski pól
• Nazwy zasobów

Dostrajanie wydajności aplikacji

Więcej informacji o tym, jak dostroić wydajność aplikacji, znajdziesz w przewodniku Wydajność.