準備客戶帳戶

在這個步驟中,您需要指定要進行 API 呼叫的 Google Ads 帳戶。帳戶可以是正式版 (上線) 帳戶或測試帳戶。每種方法都各有優缺點。

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

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

另一個做法是設定正式版帳戶,並設定低預算 (例如 $1/天),明確測試測試帳戶不支援的功能。

選擇特徵集

選擇要用來發出 API 呼叫的帳戶時,請考量您想搭配 API 使用的功能清單。即使您選擇使用正式版帳戶,仍有部分功能僅適用於特定帳戶,例如:

  • 如要使用帳單功能,您必須使用月結帳戶。
  • 帳戶中的部分新功能可能會受到許可清單的限制。

在確定要針對哪個帳戶發出 API 呼叫之前,請先查看特定功能的說明文件,確認該功能沒有其他限制。

找出登入客戶 ID 和客戶 ID

如要向 Google Ads 客戶發出 API 呼叫,您必須直接或透過已連結的管理員帳戶,將存取權和適當的權限授予服務帳戶。如要執行這項操作,您必須具備客戶帳戶的管理員存取權。

請先以管理員身分登入 Google Ads 帳戶。在某些情況下,您可能有多個可供選擇的客戶帳戶。您選取的帳戶會建立登入客戶 ID,這是某些 API 呼叫的必要標頭。

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

  • 您打算對其發出 API 呼叫的客戶帳戶 10 位數客戶 ID。有時也稱為營運客戶。

  • 您登入的客戶帳戶 10 位數登入客戶 ID。如果您已登入運作中的客戶,登入客戶 ID 就會與客戶 ID 相同。如果您登入的是營運客戶的管理員帳戶,登入客戶 ID 就是管理員帳戶的客戶 ID。

授予服務帳戶存取權

  1. 以管理員身分登入 Google Ads 帳戶後,前往「管理員」>「存取權和安全性」

  2. 按一下「使用者」分頁標籤下方的「+」按鈕。

  3. 在「電子郵件」輸入框中輸入服務帳戶的電子郵件地址。選取適當的帳戶存取層級,然後按一下「新增帳戶」按鈕。請注意,服務帳戶不支援電子郵件存取層級。

  4. 服務帳戶會獲得存取權。

根據預設,您無法將管理員存取權授予服務帳戶。如果 API 呼叫需要管理員存取權,您可以按照下列方式升級存取權。

  1. 在「存取層級」欄中,按一下服務帳戶存取層級旁的下拉式箭頭。

  2. 從下拉式清單中選取「管理」