用戶端程式庫

我們的用戶端程式庫提供 Google Ads API 功能、概要檢視和基本架構,方便您快速開發應用程式。如果您是第一次使用 API,建議您先從建立 API 開始著手。

用戶端程式庫 來源 分布 程式碼範例
Java google-ads-java Maventar.gz 前往 GitHub 查看
.NET google-ads-dotnet tar.gz、zip 前往 GitHub 查看
PHP google-ads-php tar.gz 前往 GitHub 查看
Python google-ads-python tar.gz、zip 前往 GitHub 查看
Ruby google-ads-ruby gem、tar.gz、zip 前往 GitHub 查看
PERL google-ads-perl tar.gz、zip 前往 GitHub 查看

支援的 API 版本

下表列出支援各個可用 API 版本的特定程式庫版本。

API 版本 Python 程式庫版本 Ruby 程式庫版本 PHP 程式庫版本 Java 程式庫版本 .NET 程式庫版本 Perl 程式庫版本
11 版 >= 17.0.0 >= 18.0.0 =15.1.0 >= 19.0.0 >= 12.1.0 >= 12.0.0
10 版 >= 15.0.0 >= 16.0.0 >= 14.0.0 >= 17.0.0 >= 11.0.0 >= 10.0.0
第 9 版 >= 14.1.0 >= 15.0.0 >= 12.1.0 >= 16.0.0 >= 10.2.0 >= 9.2.0

設定

每個 Ads API 用戶端程式庫都提供不同的配置設定和載入方法,方便您自訂其行為。

以下是所有用戶端程式庫通用的環境變數,並可載入以調整配置設定:

  • 用戶端程式庫
    • GOOGLE_ADS_CONFIGURATION_FILE_PATH:設定檔的路徑。
  • OAuth2
    • 應用程式模式
      • GOOGLE_ADS_CLIENT_ID:請將這個值設為您的 OAuth2 用戶端 ID。
      • GOOGLE_ADS_CLIENT_SECRET:請將這個值設為您的 OAuth2 用戶端密鑰。
      • GOOGLE_ADS_REFRESH_TOKEN :如果您想重複使用 OAuth2 憑證,請將這個值設為預先產生的 OAuth2 更新憑證。這項設定是選用項目。
    • 服務帳戶模式
      • GOOGLE_ADS_JSON_KEY_FILE_PATH:將這個值設為 OAuth2 JSON 設定檔路徑。
      • GOOGLE_ADS_IMPERSONATED_EMAIL:將這個值設為您要模擬的帳戶的電子郵件地址。
  • Google Ads API
    • GOOGLE_ADS_DEVELOPER_TOKEN :將此設為您的開發人員權杖。
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID:這是要求中授權的客戶的客戶 ID,不含連字號 (-)。
    • GOOGLE_ADS_LINKED_CUSTOMER_ID:只有在透過 Google Ads 使用者介面中的已連結帳戶 (在 Google Ads API 中為 AccountLink 資源) 授予權限時,才能更新實體資源的方法。請將這個值設為更新指定客戶 ID 資源的資料供應商客戶 ID。應不設定連字號 (-)。如要進一步瞭解已連結帳戶,請造訪說明中心