用戶端程式庫

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

我們的用戶端程式庫提供高階檢視區塊和 Google Ads API 功能的基本構成要素,方便您快速開發應用程式。如果您是第一次使用 API,建議您先從頭著手。

用戶端程式庫 來源 發布權 程式碼範例
Java google-ads-java Maventar.gz 前往 GitHub 查看
.NET google-ads-dotnet nugettar.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 版本的特定程式庫版本。

Java

API 和支援的最低/最高 Java 版本
13 版 Min: 23.0.0
Max: -
12 版 Min: 22.0.0
Max: -

C#

API 和支援的最低/最高 .NET 版本
13 版 Min: 15.0.0
Max: -
12 版 Min: 14.2.0
Max: -

PHP

API 和支援的最低/最高 PHP 版本
13 版 Min: 18.0.0
Max: -
12 版 Min: 17.1.0
Max: -

Python

API 和支援的最低/最高 Python 版本
13 版 Min: 20.0.0
Max: -
12 版 Min: 19.0.0
Max: -

Ruby

API 和支援的最低 Ruby 版本
13 版 Min: 21.0.0
Max: -
12 版 Min: 20.0.0
Max: -

Perl

API 和支援的最低/最高 Perl 版本
13 版 Min: 15.0.0
Max: -
12 版 Min: 14.0.0
Max: -

設定

每個 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 的資源。應不設定連字號 (-)。如要進一步瞭解已連結帳戶,請造訪說明中心