準備客戶帳戶

在這個步驟中,您要找出要呼叫 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 相同。