共用別名

使用 Google Ads API 時,有許多地方會使用電子郵件地址來管理聯絡人和存取權,其中最重要的是:

  • Google Ads API 聯絡電子郵件:這是 Google Ads 使用者介面 API 中心中列為聯絡人的電子郵件。
  • Google Cloud 控制台帳戶電子郵件:這是具備 Google Cloud 控制台帳戶管理員存取權的電子郵件,用於 OAuth 2.0 應用程式。
  • Google Ads 管理員帳戶電子郵件:這些電子郵件在您透過 Google Ads API 存取的管理員 Google Ads 帳戶中具備管理員權限。為應用程式產生重新整理權杖時,通常會使用其中一個電子郵件驗證 Google Ads API 應用程式。

我們強烈建議您使用共用團隊別名,這樣當個別團隊成員轉換團隊或離開公司時,您就不會失去這些帳戶的存取權。本指南的其餘部分會詳細說明上述電子郵件,以及如何更新電子郵件,以便使用共用團隊別名,而非個別使用者的電子郵件地址。

Google Ads API 聯絡電子郵件

Google Ads API 聯絡電子郵件地址是您註冊 Google Ads API 時提供的電子郵件地址。請務必確保能存取這個別名,並定期監控寄送至這個地址的電子郵件。Google 會在 API 審查、稽核要求或需要立即處理的正式版緊急情況中,使用這個電子郵件地址與您的團隊聯絡。請使用共用團隊別名做為聯絡電子郵件,確保整個團隊都能收到這些通知。

如要更新 API 聯絡電子郵件地址,請按照下列步驟操作:

  1. 登入 Google Ads 管理員帳戶

  2. 按一下畫面左下方的「管理」

  3. 在「管理員帳戶設定」下方,點選「API 中心」

  4. 在「開發人員詳細資料」下方,請記下 API 聯絡電子郵件地址。按一下向下箭頭並編輯電子郵件。按一下「儲存」

Google Cloud 控制台帳戶

Google API 控制台專案包含應用程式的 OAuth 憑證,並控管 Google Ads API 的存取權。將共用別名設為帳戶擁有者,確保您能存取這個帳戶。

如要更新 Google API 控制台專案的擁有者,請按照下列步驟操作:

  • 登入 Google API 控制台
  • 在頁面左上角的下拉式選單中選取專案。
  • 從左側選單前往「IAM 與管理」>「身分與存取權管理」
  • 按一下「授予存取權」按鈕。
  • 在「新增主要使用者」部分下方輸入共用電子郵件地址。
  • 指派「Owner」角色。
  • 按一下「儲存」按鈕。如要進一步瞭解如何授予及撤銷存取權,請參閱 Cloud 說明文件。

Google Ads 管理員帳戶

使用 Google Ads API 管理帳戶的常見方法,就是將所有帳戶連結至同一個管理員帳戶,然後使用最頂層管理員帳戶的憑證,對所有帳戶發出 API 呼叫。在這個設定中:

  • 開發人員會使用有權存取 Google Ads 管理員帳戶的使用者憑證,發出重新整理權杖。
  • 開發人員將 login_customer_id 標頭設為 Google Ads 管理員帳戶的客戶 ID,並將 customer_id 標頭設為 API 呼叫的帳戶客戶 ID。

這種設定的潛在風險是,如果授權使用者失去 Google Ads 管理員帳戶的存取權,則重新整理權杖將失效,所有 API 呼叫都會失敗。為避免這種情況發生,您可以邀請共用電子郵件別名,以適當的存取層級管理這個 Google Ads 管理員帳戶。使用這個共用電子郵件別名發出重新整理權杖,以便進行 API 呼叫。