Biblioteka klienta Perl

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

Biblioteka obsługuje Perla w wersji 5.28.1 lub nowszej.

Protokół API REST

w protokole JSON REST przez HTTP 1.1.

Klasy, takie jak usługa, zasób, wyliczenie i błąd, w bibliotece klienta Perl 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 Google Ads API, biblioteka klienta tworzy żądanie HTTP w formacie JSON, wysyła je do punktu końcowego REST za pomocą protokołu HTTP 1.1, deserializuje odpowiedź jako obiekt JSON i interpretuje wyniki.

Instalowanie biblioteki

Biblioteka klienta Perl jest hostowana na GitHub i dystrybuowana 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 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 konfiguracji logowania.
  3. Zainstaluj wymagane zależności. 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
    perl Build installdeps
    

Wykonywanie pierwszego wywołania interfejsu API

Aby korzystać z interfejsu Google Ads API, musisz wykonać kilka czynności, aby uzyskać do niego dostęp i skonfigurować konta Google Ads. Zalecamy zapoznanie się 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 korzystaniu z biblioteki klienta w Perlu znajdziesz w przewodniku po podstawowym użyciu.

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 je modyfikować, aby dostosować działanie biblioteki. Więcej informacji znajdziesz w przewodniku Logowanie.

Narzędzia

Biblioteka klienta Perl zawiera kilka klas narzędziowych, które zwiększają użyteczność interfejsu API. Aby dowiedzieć się więcej, zapoznaj się z tymi przewodnikami:

Dostosowywanie wydajności aplikacji

przewodniku po wydajności znajdziesz rekomendacje dotyczące optymalizacji wydajności aplikacji.