管理 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 電子郵件接收設定」。