用戶端程式庫

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

我們的用戶端程式庫提供高階檢視區塊和 Google Ads 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 版本的特定程式庫版本。

Java

API 和支援的最低/最高 Java 版本
12 版 Min: 22.0.0
Max: -
11 版 Min: 19.0.0
Max: -
10 版 Min: 17.0.0
Max: -

C#

API 和支援的最低/最高 .NET 版本
12 版 Min: 14.2.0
Max: -
11 版 Min: 12.1.0
Max: -
10 版 Min: 11.0.0
Max: -

PHP

API 和支援的最低/最高 PHP 版本
12 版 Min: 17.1.0
Max: -
11 版 Min: 15.1.0
Max: -
10 版 Min: 14.0.0
Max: -

Python

API 和支援的最低/最高 Python 版本
12 版 Min: 19.0.0
Max: -
11 版 Min: 17.0.0
Max: -
10 版 Min: 15.0.0
Max: -

Ruby

API 和支援的最低/Ruby 版本
12 版 Min: 20.0.0
Max: -
11 版 Min: 18.0.0
Max: -
10 版 Min: 16.0.0
Max: -

Perl

API 和支援的最低/個別 Perl 版本
12 版 Min: 14.0.0
Max: -
11 版 Min: 12.0.0
Max: -
10 版 Min: 10.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 的資源。應不設定連字號 (-)。如要進一步瞭解已連結帳戶,請前往說明中心