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