管理 Merchant Center 電子郵件通知

本指南說明如何使用 EmailPreferences 資源管理您的 Merchant Center 電子郵件通知,以及查看您帳戶的 users 會收到的電子郵件類型。如需電子郵件通知類型的完整清單,請參閱 EmailPreferences 參考資料

您只能針對已新增為使用者的帳戶,使用 Merchant API 管理電子郵件通知。

如要查看或更新電子郵件通知,您必須具備下列值:

  • 接收電子郵件的使用者電子郵件地址。您可在 User 資源的 name 欄位中找到對方的電子郵件地址。
  • 要開始或停止接收相關電子郵件的帳戶的商家 ID。如果商家帳戶是進階帳戶,且使用者可以存取進階帳戶,請使用進階帳戶的商家 ID。

啟用或停用通知

如要更新特定商家帳戶的電子郵件通知設定,請使用帳戶的 merchantId 和使用者電子郵件地址呼叫 accounts.v1beta.accounts.users.updateEmailPreference

使用以下值控管使用者收到的電子郵件通知:

  • OPTED_IN:接收帳戶的電子郵件通知。
  • OPTED_OUT:不要接收帳戶的電子郵件通知。

以下要求範例說明如何針對特定商家帳戶,為使用者取消訂閱電子郵件通知:

PATCH https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences

{
  "newsAndTips": "OPTED_OUT"
}

查看現有通知

如要查看特定使用者目前的電子郵件通知設定,請呼叫 accounts.v1beta.accounts.users.getEmailPreferences

以下是要求示例,其中 merchantId 是電子郵件通知的相關帳戶 ID,emailAddress 是接收電子郵件的使用者電子郵件地址。

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences

以下是成功呼叫的回應範例:

{
  "name": "accounts/merchantId/users/emailAddress/emailPreferences",
  "newsAndTips": "OPTED_IN"
}

如要進一步瞭解電子郵件通知,請參閱「變更 Merchant Center 電子郵件接收設定」一文。