快速入門導覽課程

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

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

如要啟用 API 存取權,請先取得必要的 OAuth2 憑證。

接著,將設定檔和帳戶詳細資料新增至設定檔。設定檔設定完成後,您就可以開始呼叫 API。

用戶端程式庫的設定參數

在用戶端程式庫的設定檔中提供下列資訊。

開發人員權仗:

您的開發人員權杖可讓應用程式存取 API,但權杖則不限於一個 Google Ads 帳戶。權杖獲準後,您可以使用同一個權杖來對您所有 Google Ads 帳戶提出請求,即使這些權杖未連結至與權杖相關聯的 Google Ads 管理員帳戶也一樣。

您管理的帳戶是由管理員帳戶的 OAuth 憑證授權。管理員帳戶只需要一組憑證,即可管理所有子帳戶。

只有已核准的權杖才能連線到實際工作環境的 Google Ads 帳戶,待處理的權杖則只能連結至測試帳戶。

如要擷取開發人員權杖,請登入管理員帳戶,然後前往 API 中心 (TOOLS & SETTINGS > SETUP > API Center)。

客戶帳戶中顯示的客戶 ID

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

您可以視需要將設定檔客戶 ID 從設定檔留空,再透過程式設定。開發人員權杖獲得核准後,您可以使用正式版帳戶中的用戶端客戶 ID,而非測試帳戶

OAuth2 用戶端 ID 和密鑰

OAuth2 用戶端 ID 和用戶端密鑰對應用戶端應用程式與 Google API 控制台中的專案,並用於 OAuth2 驗證,讓應用程式能代表您的帳戶運作。可讓 Google 識別您的應用程式,並產生 OAuth 權杖來管理 Google Ads 使用者。詳情請參閱「建立用戶端 ID 和用戶端密鑰」。

OAuth2 存取及更新憑證

應用程式必須先取得授予 API 存取權的 OAuth2 存取權杖,才能使用 API 存取私人資料。

如果您使用用戶端程式庫,則會為您自動處理 OAuth2 存取權杖。否則,請嘗試透過 OAuth Playground 取得憑證。

OAuth2 存取憑證在限制時間過後隨即失效。因此,用戶端程式庫會使用 OAuth2 更新權杖自動重新產生 OAuth2 存取權杖。存取及重新整理權杖提供建立更新權杖的操作說明。