準備客戶帳戶

在這個步驟中,您需要找出要呼叫 API 的 Google Ads 帳戶。您需要其電子郵件地址,才能產生 OAuth 2.0 更新憑證。該帳戶可以是實際執行 (即時) 帳戶或測試帳戶。每個方法都各有優缺點。

實際執行帳戶
測試帳戶
優點
  • 更輕鬆地編寫和測試適用於特定帳戶內容的程式碼。
  • 較易於編寫及測試用於處理即時報表資料的程式碼。
  • 測試帳戶不會放送廣告,因此程式設計錯誤不會影響已上線的廣告活動。
  • 適用於具備測試存取層級的開發人員權杖。
缺點
  • 開發階段中的程式設計錯誤可能會影響放送中的廣告活動,進而導致廣告活動成效不佳、放送不正確或財務損失。
  • 開發人員權杖至少應具備基本存取層級,才能發出 API 呼叫。
  • 您必須在測試帳戶中重建廣告活動,才能測試適用於特定帳戶內容的程式碼。
  • 由於測試帳戶不會放送廣告,因此系統不支援與即時放送相關的功能 (例如報表統計資料、違反政策錯誤或處理離線轉換匯入),因此難以測試這些功能。

建議您盡可能在開發應用程式時使用測試帳戶。如需操作說明,請參閱「建立測試帳戶和廣告活動」。

替代方法是設定較低的帳戶預算 (例如每日 $1 美元),明確用來測試測試帳戶不支援的功能。

功能組合選項

選擇要執行 API 呼叫的帳戶時,系統會另外考量您想搭配 API 使用的功能清單。即使您選擇使用實際執行帳戶,也會有一些帳戶專屬的功能,例如:

  • 如要使用帳單功能,您的帳戶必須採用月結付款。
  • 部分新功能可能會僅限許可清單中的帳戶使用,

完成要執行 API 呼叫的帳戶前,請先參閱該功能的說明文件,確認功能沒有其他限制。

使用者存取權、登入客戶 ID 和客戶 ID

如要向 Google Ads 客戶進行 API 呼叫,您必須直接存取該客戶,或透過已連結的管理員帳戶存取。此外,您也需要具備特定 API 呼叫的適當權限。

登入 Google Ads 時,可能會有多個客戶帳戶可供選擇。您選取的帳戶會建立登入客戶 ID,這是某些 API 呼叫的必要標頭,以及您的存取層級。

找出要執行 API 呼叫的 Google Ads 客戶後,請注意下列詳細資料:

  • 要進行 API 呼叫的客戶帳戶的 10 位數客戶 ID。這有時也稱為營運客戶。

  • 您登入的客戶帳戶的電子郵件地址。如此才能產生 OAuth 2.0 更新權杖。

  • 您所登入客戶帳戶的 10 位數登入客戶 ID。 如果您已登入營運客戶,登入客戶 ID 會與客戶 ID 相同。