快速入門導覽課程

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

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

然後將授權和帳戶詳細資訊加入設定檔。設定檔設定完成後,您就可以呼叫 API。

用戶端程式庫的設定參數

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

開發人員權仗:

您的開發人員權杖可讓您的應用程式存取 API,但該權杖不限於只有一個 Google Ads 帳戶。憑證獲準後,您就能對所有 Google Ads 帳戶使用同一個請求,即使這些帳戶並未與權杖相關的 Google Ads 管理員帳戶連結也沒問題。

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

只有已核准的權杖才能連結至 API 用於實際工作環境的 Google Ads 帳戶;待處理的權杖只能連結至測試帳戶。

登入管理員帳戶,然後前往 API 中心 (「工具與設定」>「設定」>「API 中心」),即可擷取開發人員權杖。

客戶帳戶中顯示的客戶 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 存取憑證。存取與重新整理憑證說明如何建立重新整理憑證。