Thư viện ứng dụng Perl

Thư viện ứng dụng Perl được lưu trữ trên GitHub và gói này có trên CPAN.

Thư viện này hỗ trợ Perl phiên bản 5.28.1 trở lên.

Giao thức API REST

Lưu ý: Google Ads API hiển thị cả điểm cuối JSON REST tiêu chuẩn và giao diện gRPC hiệu suất cao. Vì Perl không phải là ngôn ngữ được hỗ trợ trong ngăn xếp gRPC, nên thư viện ứng dụng này được triển khai trên giao thức JSON REST qua HTTP 1.1.

Các thực thể lớp (chẳng hạn như dịch vụ, tài nguyên, enum và lỗi) trong thư viện ứng dụng Perl được tạo bằng cách phân tích cú pháp định nghĩa vùng đệm giao thức. Để tìm hiểu thêm về cách chuyển đổi tuần tự dữ liệu có cấu trúc, hãy tham khảo tài liệu về vùng đệm giao thức.

Để kết nối với Google Ads API, thư viện ứng dụng sẽ tạo một yêu cầu HTTP trong JSON, gửi yêu cầu đó đến điểm cuối REST qua HTTP 1.1, giải tuần tự hoá phản hồi dưới dạng đối tượng JSON và diễn giải kết quả.

Cài đặt thư viện

Thư viện ứng dụng Perl được lưu trữ trên GitHub và được phân phối bằng CPAN.

Cài đặt từ CPAN

Cài đặt bản phân phối Google::Ads::GoogleAds::Client trực tiếp từ CPAN bằng cpanm (hoặc cpan):

cpanm Google::Ads::GoogleAds::Client

Lưu ý: Mỗi bản phát hành Google::Ads::GoogleAds::Client đều có các mô-đun phiên bản Google Ads API cụ thể trong lib/Google/Ads/GoogleAds/ (trong đó các bản phát hành API nhỏ như v25.1 được đưa vào mô-đun phiên bản lớn, V25). Hãy xem bảng các phiên bản API được hỗ trợ để biết khả năng tương thích của phiên bản.

Tạo bản dựng từ nguồn và chạy ví dụ

Cách chạy các ví dụ về mã đi kèm hoặc tạo thư viện từ nguồn:

1. Sao chép thư viện từ GitHub:

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

2. Chuyển sang thư mục google-ads-perl:

   cd google-ads-perl
   

   Bạn sẽ thấy một số tệp và thư mục con:

   • Build.PL: tệp bản dựng Perl, chứa các phần phụ thuộc và loại kiểm thử của dự án này.
   • lib: mã nguồn của thư viện.
   • t: các trường hợp kiểm thử của mã thư viện.
   • examples: nhiều ví dụ minh hoạ cách sử dụng thư viện để thực thi các trường hợp sử dụng phổ biến bằng Google Ads API.
   • googleads.properties: tệp cấu hình mẫu cho thư viện.
   • log4perl.conf: tệp cấu hình ghi nhật ký mẫu.

3. Cài đặt các phần phụ thuộc bắt buộc và tạo thư viện. Tệp Build.PL liệt kê tất cả các phần phụ thuộc cần thiết cho thư viện. Bạn có thể cài đặt các phần phụ thuộc này bằng cách chạy các lệnh sau:

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

Thực hiện lệnh gọi API đầu tiên

Để sử dụng Google Ads API, bạn cần thực hiện một số bước để có quyền truy cập vào API này và định cấu hình tài khoản Google Ads. Làm theo hướng dẫn bắt đầu nhanh để tìm hiểu tất cả các bước quan trọng, bao gồm cả việc thiết lập tài khoản Google Ads.

Cách sử dụng cơ bản

Khởi chạy Google::Ads::GoogleAds::Client (tải thông tin xác thực từ ~/googleads.properties hoặc GOOGLE_ADS_CONFIGURATION_FILE_PATH theo mặc định) và truyền trực tuyến các hàng của chiến dịch bằng 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};
  });

Hãy tham khảo hướng dẫn sử dụng cơ bản để tìm hiểu thêm về cách sử dụng thư viện ứng dụng Perl.

Xác thực và uỷ quyền

Thư viện ứng dụng Perl hỗ trợ nhiều phương pháp xác thực và uỷ quyền. Hãy tham khảo hướng dẫn Xác thực và uỷ quyền để tìm hiểu thêm.

Cấu hình và ghi nhật ký

Thư viện ứng dụng Perl sử dụng googleads.properties để định cấu hình và log4perl.conf để ghi nhật ký. Bạn có thể sửa đổi các tệp này để tuỳ chỉnh hành vi của thư viện. Hãy tham khảo hướng dẫn về Cấu hình và Ghi nhật ký để tìm hiểu thêm.

Tiện ích

Thư viện ứng dụng Perl bao gồm các lớp tiện ích để cải thiện khả năng hữu dụng của API. Hãy tham khảo các hướng dẫn sau để tìm hiểu thêm:

• Mặt nạ trường
• Tên tài nguyên

Tinh chỉnh hiệu suất ứng dụng

Tham khảo Hướng dẫn về hiệu suất để biết các đề xuất về cách tinh chỉnh hiệu suất của ứng dụng.