Gerenciar notificações por e-mail do Merchant Center

Neste guia, explicamos como usar o EmailPreferences para gerenciar seu e-mail do Merchant Center notificações e saber quais tipos de e-mails da sua conta users receber. Para ver a lista completa dos tipos de notificação por e-mail, consulte a EmailPreferences Referência.

Você só pode usar a API Merchant para gerenciar notificações por e-mail para contas em que você foi adicionado como um usuário.

Para acessar ou atualizar as notificações por e-mail, você precisa dos seguintes valores:

  • O endereço de e-mail do usuário que recebe os e-mails. Lá você encontra endereço de e-mail no campo name do recurso User.
  • O ID do comerciante da conta para começar ou parar de receber e-mails. Se a conta do comerciante é um nível avançado do Google, e o usuário tem aos recursos avançados conta, use o ID do comerciante da conta avançada.

Ativar ou desativar as notificações

Para atualizar as configurações de notificação por e-mail de uma conta do comerciante específica, ligue accounts.v1beta.accounts.users.updateEmailPreference pelo merchantId da conta e o endereço de e-mail do usuário.

Use os seguintes valores para controlar as notificações por e-mail que o usuário recebe:

  • OPTED_IN: recebe notificações por e-mail da conta.
  • OPTED_OUT: não receber notificações por e-mail sobre a conta.

Este é um exemplo de solicitação para desativar as notificações por e-mail de um usuário conta do comerciante:

PATCH https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences

{
  "newsAndTips": "OPTED_OUT"
}

Ver notificações existentes

Para ver as configurações atuais de notificação por e-mail de um usuário específico, chame accounts.v1beta.accounts.users.getEmailPreferences

Este é um exemplo de solicitação, em que merchantId é o ID do comerciante da conta a que se referem as notificações por e-mail, e o emailAddress é o e-mail do usuário que recebe os e-mails.

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences

Este é um exemplo de resposta de uma chamada bem-sucedida:

{
  "name": "accounts/merchantId/users/emailAddress/emailPreferences",
  "newsAndTips": "OPTED_IN"
}

Para mais informações sobre as notificações por e-mail, consulte Alterar o Merchant Center preferências de e-mail.