快速入門導覽課程

本指南使用用戶端程式庫擷取 Google Ads 廣告活動。

如要啟用 API 存取權,請先取得必要的 OAuth2 憑證。接著,將授權和帳戶詳細資料新增至設定檔。設定檔設定完成後,您就能開始呼叫 API。

必要條件

設定參數

您需要在用戶端程式庫的設定檔中提供以下資訊。

開發人員權仗:

您的開發人員權杖可讓應用程式存取 API,但該權杖只適用於一個 Google Ads 帳戶。權杖獲得核准後,您就能對所有 Google Ads 帳戶發出的請求使用相同的憑證,即使這些權杖並未連結至與權杖相關的 Google Ads 管理員帳戶也一樣。 您管理的帳戶是由管理員帳戶的 OAuth 憑證進行授權。管理員帳戶只需要一組憑證即可管理其所有子帳戶。

只有核准的權杖才能連結到 API,以供實際執行 Google Ads 帳戶使用,而待處理的權杖則只能連結至測試帳戶。

如要擷取開發人員權杖,請登入「manager」帳戶,然後前往 API 中心 ([工具與設定]/[設定] > [API 中心])。

重點

  • 一家公司只能有一個開發人員權杖。
  • 一旦開發人員權杖使用 Google Cloud 專案的用戶端 ID,用戶端 ID 就會與開發人員權杖繫結,且不能與其他開發人員權杖一起使用。換句話說:
    • 開發人員權杖可與多個用戶端編號搭配使用。
    • 不過,用戶端 ID 只能與「一個」開發人員權杖搭配使用。
客戶帳戶中顯示的客戶 ID

用戶端客戶 ID 是指您要使用 API 管理的 Google Ads 客戶帳戶 ID,通常格式為 123-456-7890

您可以選擇將用戶端客戶 ID 從設定檔中移出,並以程式輔助方式設定。開發人員權杖獲得核准後,您就能使用正式版帳戶中的用戶端客戶 ID,而不是測試帳戶

OAuth2 用戶端 ID 和密鑰

OAuth2 用戶端 ID 和用戶端密鑰會將用戶端應用程式對應至 Google API 控制台中的專案,並用於 OAuth2 驗證,讓應用程式能代表您的帳戶運作。讓 Google 識別您的應用程式,並為您產生管理 Google Ads 使用者的 OAuth 憑證。

詳情請參閱建立用戶端 ID 和用戶端密鑰

OAuth2 存取及更新憑證

您的應用程式必須先取得獲得 API 存取權的 OAuth2 存取憑證,才能使用 API 存取私人資料。

若您使用用戶端程式庫,系統會自動為您處理 OAuth2 存取憑證。否則,請參閱 OAuth2 指南中的 API 呼叫範例,進一步瞭解如何產生存取憑證。

OAuth2 存取憑證在限制時間過後隨即失效。因此,用戶端程式庫會使用 OAuth2 更新憑證來自動產生 OAuth2 存取憑證。

OAuth2 存取權和重新整理憑證提供建立更新憑證的操作說明。

如要進一步瞭解如何將 OAuth2 與 Google API 搭配使用,請參閱 OAuth2 驗證OAuth2 Identity Platform 說明文件。