共用別名

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

  • Google Ads API 聯絡電子郵件:這是 Google Ads API API 中心內列為聯絡人的電子郵件。
  • Google Cloud Console 帳戶電子郵件:此電子郵件擁有系統管理員權限,可存取 OAuth 2.0 應用程式所用的 Google Cloud Console 帳戶。
  • Google Ads 管理員帳戶電子郵件:這些電子郵件擁有您透過 Google Ads API 存取的管理員 Google Ads 帳戶管理員權限。為應用程式產生更新權杖時,您通常會使用其中一封電子郵件驗證 Google Ads API 應用程式。

強烈建議您使用共用團隊別名,以免在個別團隊成員更換團隊或離開公司時,繼續存取這些帳戶。本指南的其餘部分會介紹前述的每封電子郵件,以及如何將其更新為使用共用團隊別名,而非個別使用者的電子郵件地址。

Google Ads API 聯絡電子郵件

Google Ads API 聯絡電子郵件是您註冊 Google Ads API 時提供的電子郵件地址。您應確保能存取這個別名,並監控定期傳送至這個地址的電子郵件。在 API 審查、稽核要求或正式環境發生緊急情況時,Google 會透過這個電子郵件地址與您的團隊聯絡。使用共用團隊別名做為聯絡人電子郵件地址,確保整個團隊都會收到通知。

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

  • 登入申請 Google Ads API 存取權時使用的 Google Ads 管理員帳戶。這是您開發人員權杖所在的帳戶。
  • 依序前往「工具與設定」>「API 中心」
  • 按一下「API 聯絡電子郵件」專區下方的箭頭。
  • 更新電子郵件地址,然後按一下「Save」按鈕。

Google Cloud 控制台帳戶

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

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

  • 登入 Google API 控制台
  • 從頁面左上角的下拉式選單中選取您的專案。
  • 依序前往左側選單的「IAM 與管理員」>「IAM」
  • 按一下「授予存取權」按鈕。
  • 在「新增主體」部分下方輸入共用電子郵件地址。
  • 指派「擁有者」角色。
  • 按一下「Save」按鈕。請參閱 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 呼叫。