本指南将介绍如何使用
EmailPreferences
用于管理 Merchant Center 电子邮件的
通知,并了解有哪些
您账号的电子邮件类型
users
收到。
有关电子邮件通知类型的完整列表,请参阅 EmailPreferences
参考文档。
您只能使用 Merchant API 管理电子邮件通知 对于您已添加为 用户。
如需查看或更新电子邮件通知,您需要以下值:
- 接收电子邮件的用户的电子邮件地址。您可以在
在
User
资源的name
字段中填写电子邮件地址。 - 要开始或停止接收相关电子邮件的账号的商家 ID。如果 该商家账号是高级 账号,而用户 高级 账号,请使用商家 ID 高级账号的权限。
选择接收或停止接收通知
要更新特定商家账号的电子邮件通知设置,请调用
accounts.v1beta.accounts.users.updateEmailPreference
替换为账号的 merchantId
和用户的电子邮件地址。
使用以下值来控制用户收到的电子邮件通知:
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
是
电子邮件通知所涉及的账号,emailAddress
是电子邮件
接收电子邮件的用户的电子邮件地址。
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences
以下是成功调用的响应示例:
{
"name": "accounts/merchantId/users/emailAddress/emailPreferences",
"newsAndTips": "OPTED_IN"
}
如需详细了解电子邮件通知,请参阅更改 Merchant Center 账号 电子邮件接收设置。