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 recibe la users de tu cuenta. Para obtener 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 las notificaciones por correo electrónico de las cuentas en las que te agregan como usuario.

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

  • Es 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.
  • El ID de comerciante de la cuenta sobre la que quieres comenzar a recibir o dejar de recibir correos electrónicos Si la cuenta del comercio es una cuenta avanzada y el usuario tiene acceso a ella, usa el ID del comercio 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: Recibir notificaciones por correo electrónico de la cuenta
  • OPTED_OUT: No recibir notificaciones por correo electrónico de la cuenta.

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

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

{
  "newsAndTips": "OPTED_OUT"
}

Cómo ver las notificaciones existentes

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

Esta es una solicitud de muestra, en la que merchantId es el ID del comerciante de la cuenta sobre la que se envían 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

Esta es una respuesta de ejemplo de una llamada correcta:

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

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