準備客戶帳戶

在這個步驟中,您要找出用來進行 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. 從下拉式清單中選取「管理員」