使用 Google Ads API 時，電子郵件地址會用於多個地方，以便管理聯絡資訊和存取權管理。其中最重要的包括：
- Google Ads API 聯絡電子郵件：在 Google Cloud 專案中指派為「擁有者」或「編輯者」角色的電子郵件地址，Google 會用來傳送必要服務公告 (MSA) 和管理通知。
- Google Cloud 控制台帳戶電子郵件：用於 OAuth 2.0 應用程式的 Google Cloud 雲端專案，其管理員電子郵件地址。
- Google Ads 管理員帳戶存取權：服務帳戶 (建議) 或共用電子郵件別名，用於存取透過 Google Ads API 存取的 Google Ads 管理員帳戶。
本指南其餘部分將詳細說明上述各個帳戶，以及如何設定這些帳戶，讓整合不依賴個別使用者的電子郵件地址。
Google Ads API 聯絡電子郵件
Google 會傳送管理通知、API 審查更新、稽核要求、強制性服務公告 (MSA) 和正式環境緊急通訊，傳送對象為 Google Cloud 專案中與「擁有者」和「編輯者」角色相關聯的電子郵件地址 (請參閱「新的 API 聯絡電子郵件」，因為 Google Ads 使用者介面中的舊版 API 中心聯絡電子郵件設定已停用)。
如要更新聯絡電子郵件地址，並確保整個團隊都能收到這些通知，請將擁有者或編輯者角色授予 Google Cloud 專案中的共用團隊別名，並定期監控傳送至該別名的電子郵件。
Google Cloud 控制台帳戶
Google Cloud 控制台專案包含應用程式的 OAuth 憑證，並控管 Google Ads API 的存取權。請將擁有者 (或編輯者) 角色授予共用團隊別名，確保能存取這項專案。
請按照下列步驟，將共用別名新增為 Google Cloud 專案擁有者：
- 登入 Google Cloud 控制台。
- 從頁面頂端的專案選取器中選取專案。
- 在導覽選單中，依序前往「IAM & Admin」(IAM 與管理) >「IAM」(身分與存取權管理)。
- 點選「授予存取權」。
- 在「Add principals」(新增主體) 區段中，在「New principals」(新增主體) 欄位輸入共用電子郵件地址。
- 在「Assign roles」(指派角色) 區段中，按一下「Select a role」(選取角色)，然後依序選取「Basic」(基本) >「Owner」(擁有者) (或「Basic」(基本) >「Editor」(編輯者))。
- 按一下 [儲存]。如果您將「擁有者」角色授予 Google Cloud 組織外部的電子郵件地址 (或不屬於組織的專案)，Google Cloud 會傳送邀請電子郵件至共用別名，對方必須接受邀請，角色才會生效。請參閱 Cloud 說明文件，進一步瞭解如何授予及撤銷存取權。
Google Ads 管理員帳戶
使用 Google Ads API 管理帳戶的常見方法，是將所有帳戶連結至同一個管理員帳戶，並使用最上層管理員帳戶的憑證，對所有帳戶發出 API 呼叫。在這個設定中，開發人員會將 login-customer-id 要求標頭 (或 login_customer_id 用戶端程式庫設定) 設為 Google Ads 管理員帳戶的 10 位數客戶 ID (不含連字號)，並將目標 customer_id 設為發出 API 呼叫的作業帳戶。
建議做法：使用服務帳戶
建議使用服務帳戶驗證及存取 Google Ads 管理員帳戶。與個人使用者帳戶不同，服務帳戶是在 Google Cloud 專案中管理，不與特定人員綁定，因此不會因團隊成員變更角色或離職而中斷服務。請按照服務帳戶指南建立服務帳戶，並授予 Google Ads 管理員帳戶存取權。
替代方案：使用共用電子郵件別名
如果整合項目無法使用服務帳戶，而是依賴單一使用者驗證工作流程，則有權存取 Google Ads 管理員帳戶的使用者會核發 OAuth 2.0 更新權杖。
如要在使用使用者憑證時避免這種情況，請按照下列步驟操作：
- 邀請共用電子郵件別名 (由已啟用密碼金鑰驗證的有效 Google 帳戶支援)，以適當的存取層級管理這個 Google Ads 管理員帳戶。
- 使用共用電子郵件別名接受邀請。
- 使用這個共用電子郵件別名，核發 OAuth 更新權杖，以便發出 API 呼叫。