Biblioteka klienta Perl

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

Biblioteka obsługuje Perla w wersji 5.28.1 lub nowszej.

Protokół REST API

Jednostki klas, 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 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 w Perlu jest hostowana w 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: przypadki testowe kodu biblioteki.
    • examples: wiele przykładów, które pokazują, 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. Wszystkie zależności wymagane przez bibliotekę są wymienione w pliku Build.PL. Możesz je zainstalować, uruchamiając te polecenia:

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

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. Zalecamy zapoznanie się z przewodnikiem Szybki start guide, który przeprowadzi Cię przez wszystkie ważne kroki, w tym konfigurację kont Google Ads.

Podstawowe użycie

Więcej informacji o korzystaniu z biblioteki klienta w Perlu znajdziesz w przewodniku Podstawowe użycie.

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 przewodniku Logowanie.

Narzędzia

Biblioteka klienta w Perlu zawiera kilka klas narzędziowych, które ułatwiają korzystanie z interfejsu API. Aby dowiedzieć się więcej, zapoznaj się z tymi przewodnikami:

Dostrajanie wydajności aplikacji

Więcej informacji o dostrajaniu wydajności aplikacji znajdziesz w przewodniku Wydajność.