Library Klien Perl

Library klien Perl dihosting di GitHub, dan paketnya tersedia di CPAN.

Library ini mendukung Perl versi 5.28.1 atau yang lebih baru.

Protokol REST API

Entitas class—seperti layanan, resource, enum, dan error—di library klien Perl dihasilkan dengan mengurai definisi buffer protokol. Untuk mempelajari lebih lanjut cara data terstruktur diserialisasi, lihat dokumentasi buffer protokol.

Untuk terhubung dengan Google Ads API, library klien membuat permintaan HTTP dalam JSON, mengirimkannya ke endpoint REST melalui HTTP 1.1, mendeserialisasi respons sebagai objek JSON, dan menafsirkan hasilnya.

Menginstal library

Library klien Perl dihosting di GitHub dan didistribusikan menggunakan CPAN.

  1. Clone library dari GitHub:

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

  2. Ubah ke direktori google-ads-perl:

    cd google-ads-perl

    Anda akan melihat beberapa file dan subdirektori:

    • Build.PL: file build Perl, yang menyimpan dependensi dan jenis pengujian project ini.
    • lib: kode sumber library.
    • t: kasus pengujian kode library.
    • examples: banyak contoh yang menunjukkan cara menggunakan library untuk mengeksekusi kasus penggunaan umum menggunakan Google Ads API.
    • googleads.properties: file konfigurasi contoh untuk library.
    • log4perl.conf: file konfigurasi logging contoh.

  3. Instal dependensi yang diperlukan. File Build.PL mencantumkan semua dependensi yang diperlukan untuk library. Anda dapat menginstalnya dengan menjalankan perintah berikut:

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

Lakukan panggilan API pertama Anda

Untuk menggunakan Google Ads API, Anda harus melakukan beberapa langkah untuk mendapatkan akses ke API dan mengonfigurasi akun Google Ads Anda. Sebaiknya ikuti panduan memulai cepat, yang akan memandu Anda melakukan semua langkah penting, termasuk menyiapkan akun Google Ads.

Penggunaan dasar

Lihat panduan penggunaan dasar untuk mempelajari lebih lanjut cara menggunakan library klien Perl.

Autentikasi dan otorisasi

Library klien Perl mendukung beberapa pendekatan untuk autentikasi dan otorisasi. Lihat panduan Autentikasi dan Otorisasi untuk mempelajari lebih lanjut.

Konfigurasi dan logging

Library klien Perl menggunakan googleads.properties untuk konfigurasi dan log4perl.conf untuk logging. Anda dapat mengubah file ini untuk menyesuaikan perilaku library. Lihat panduan Logging untuk mempelajari lebih lanjut.

Utilitas

Library klien Perl menyertakan beberapa class utilitas untuk meningkatkan kegunaan API. Lihat panduan berikut untuk mempelajari lebih lanjut:

Menyesuaikan performa aplikasi

Lihat Panduan performa untuk mengetahui rekomendasi tentang cara menyempurnakan performa aplikasi Anda.