Perl 用戶端程式庫

Perl 用戶端程式庫託管於 GitHub，且套件可在 CPAN 上取得。

這個程式庫支援 Perl 5.28.1 以上版本。

REST API 通訊協定

Perl 用戶端程式庫中的類別實體 (例如服務、資源、列舉和錯誤) 是透過剖析通訊協定緩衝區定義產生。如要進一步瞭解結構化資料的序列化方式，請參閱通訊協定緩衝區說明文件。

如要連線至 Google Ads API，用戶端程式庫會以 JSON 建立 HTTP 要求，透過 HTTP 1.1 將要求傳送至 REST 端點，將回應還原序列化為 JSON 物件，然後解讀結果。

安裝程式庫

Perl 用戶端程式庫託管於 GitHub，並使用 CPAN 發布。

  1. 從 GitHub 複製程式庫：

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

  2. 變更至 google-ads-perl 目錄：

    cd google-ads-perl

    您會看到一些檔案和子目錄：

    • Build.PL：Perl 建構檔案，其中包含這個專案的依附元件和測試類型。
    • lib：程式庫的原始碼。
    • t：程式庫程式碼的測試案例。
    • examples：許多範例，說明如何使用程式庫，透過 Google Ads API 執行常見用途。
    • googleads.properties：程式庫的範例設定檔。
    • log4perl.conf：記錄設定檔範例。

  3. 安裝必要的依附元件。Build.PL 檔案會列出程式庫所需的所有依附元件。執行下列指令即可安裝：

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

進行第一次 API 呼叫

如要使用 Google Ads API，您必須完成幾個步驟，才能存取 API 並設定 Google Ads 帳戶。建議您參閱快速入門指南，瞭解所有重要步驟，包括設定 Google Ads 帳戶。

基本用法

如要進一步瞭解如何使用 Perl 用戶端程式庫，請參閱基本使用指南。

驗證及授權

Perl 用戶端程式庫支援多種驗證和授權方法。詳情請參閱「驗證與授權」指南。

設定和記錄

Perl 用戶端程式庫會使用 googleads.properties 進行設定，並使用 log4perl.conf 記錄。您可以修改這些檔案，自訂程式庫的行為。詳情請參閱記錄指南。

公用程式

Perl 用戶端程式庫包含幾個實用類別，可提升 API 的可用性。參閱下列指南，瞭解更多資訊：

微調應用程式效能

請參閱效能指南，瞭解如何微調應用程式效能。