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 recursoUser
. - 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.