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