本指南使用用戶端程式庫擷取 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 存取憑證。存取與重新整理憑證說明如何建立重新整理憑證。