Administra las notificaciones por correo electrónico de Merchant Center

En esta guía, se explica cómo usar el recurso EmailPreferences para administrar tus notificaciones por correo electrónico de Merchant Center y ver qué tipos de correos electrónicos reciben los users de tu cuenta. Para ver la lista completa de los tipos de notificaciones por correo electrónico, consulta la referencia de EmailPreferences.

Solo puedes usar la API de Merchant para administrar notificaciones por correo electrónico de las cuentas en las que se te agrega como usuario.

Para ver o actualizar las notificaciones por correo electrónico, necesitas los siguientes valores:

  • La dirección de correo electrónico del usuario que recibe los correos electrónicos. Puedes encontrar su dirección de correo electrónico en el campo name del recurso User.
  • Es el ID del comerciante de la cuenta sobre la que se deben comenzar a recibir correos electrónicos o sobre la que se dejará de recibir. Si la cuenta del comerciante es una cuenta avanzada y el usuario tiene acceso a ella, usa el ID del comerciante de la cuenta avanzada.

Cómo habilitar o inhabilitar las notificaciones

Para actualizar la configuración de notificaciones por correo electrónico de una cuenta de comerciante específica, llama a accounts.v1beta.accounts.users.updateEmailPreference con el merchantId de la cuenta y la dirección de correo electrónico del usuario.

Usa los siguientes valores para controlar las notificaciones por correo electrónico que recibe el usuario:

  • OPTED_IN: Recibe notificaciones por correo electrónico para la cuenta.
  • OPTED_OUT: No recibirás notificaciones por correo electrónico para la cuenta.

A continuación, se incluye un ejemplo de una solicitud para inhabilitar las notificaciones por correo electrónico de un usuario de una cuenta de comerciante específica:

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

{
  "newsAndTips": "OPTED_OUT"
}

Ver notificaciones existentes

Para ver la configuración actual de notificaciones por correo electrónico de un usuario específico, llama a accounts.v1beta.accounts.users.getEmailPreferences.

Esta es una solicitud de ejemplo, en la que merchantId es el ID del comerciante de la cuenta sobre la que se tratan las notificaciones por correo electrónico y emailAddress es la dirección de correo electrónico del usuario que recibe los correos electrónicos.

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

Este es un ejemplo de respuesta de una llamada exitosa:

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

Para obtener más información sobre las notificaciones por correo electrónico, consulta Cambia tus preferencias de correo electrónico de Merchant Center.