共用別名

使用 Google Ads API 時,電子郵件地址會顯示在多個地方,可用來管理聯絡人和存取權,請特別注意以下幾點:

  • Google Ads API 聯絡電子郵件:這個電子郵件地址在 Google Ads 使用者介面的 API 中心列為聯絡人。
  • Google Cloud Console 帳戶電子郵件:這類電子郵件具有 OAuth 2.0 應用程式所用 Google Cloud 控制台帳戶的管理員權限。
  • 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 管理員帳戶。這是您的開發人員權杖所在的帳戶。
  • 依序前往「Tools & Settings」>「API Center」
  • 按一下「API 聯絡電子郵件」部分下方的箭頭。
  • 更新電子郵件地址,然後按一下「儲存」按鈕。

Google Cloud 控制台帳戶

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

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

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