管理 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 电子邮件接收设置