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

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 bộ đệm giao thức. Để tìm hiểu thêm về cách dữ liệu có cấu trúc được chuyển đổi tuần tự, hãy tham khảo tài liệu về vùng đệm giao thức.

Để kết nối với API Google Ads, thư viện ứng dụng sẽ tạo một yêu cầu HTTP ở định dạng 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 một đố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à phân phối bằng CPAN.

  1. Sao chép thư viện trên GitHub:

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

  2. Thay đổi thành 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. 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 gói này bằng cách chạy các lệnh sau:

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

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

Để sử dụng API Google Ads, bạn cần thực hiện một số bước để có quyền truy cập vào API và định cấu hình tài khoản Google Ads. Bạn nên làm theo hướng dẫn bắt đầu nhanh. Hướng dẫn này sẽ giúp bạn thực hiện 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

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 dùng googleads.properties cho cấu hình và log4perl.conf cho hoạt động 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ề Ghi nhật ký để tìm hiểu thêm.

Tiện ích

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

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.