本指南說明如何使用 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 電子郵件接收設定」一文。