本指南介绍了如何使用 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 电子邮件接收设置。