Ce guide explique comment utiliser le
EmailPreferences
ressource pour gérer votre adresse e-mail Merchant Center
des notifications, et identifiez
les types d'e-mails envoyés par votre compte
users
reçus.
Pour obtenir la liste complète des types de notifications par e-mail, consultez le EmailPreferences
référence.
Vous ne pouvez utiliser l'API Merchant Center que pour gérer les notifications par e-mail pour les comptes dans lesquels vous êtes ajouté en tant que utilisateur.
Pour afficher ou mettre à jour les notifications par e-mail, vous avez besoin des valeurs suivantes:
- Adresse e-mail de l'utilisateur qui reçoit les e-mails. Vous trouverez leurs
dans le champ
name
de la ressourceUser
. - Référence marchand du compte pour lequel vous voulez recevoir ou arrêter de recevoir des e-mails. Si le compte marchand est un compte avancé compte, et l'utilisateur a l'accès avancé , utilisez la référence marchand du compte avancé.
Activer ou désactiver les notifications
Pour mettre à jour les paramètres de notification par e-mail pour un compte marchand spécifique, appelez
accounts.v1beta.accounts.users.updateEmailPreference
avec l'merchantId
du compte et l'adresse e-mail de l'utilisateur.
Utilisez les valeurs suivantes pour contrôler les notifications par e-mail que l'utilisateur reçoit:
OPTED_IN
: recevez des notifications par e-mail concernant le compte.OPTED_OUT
: vous ne recevez pas de notifications par e-mail pour le compte.
Voici un exemple de demande permettant de désactiver les notifications par e-mail pour un utilisateur compte marchand:
PATCH https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences
{
"newsAndTips": "OPTED_OUT"
}
Afficher les notifications existantes
Pour afficher les paramètres actuels de notification par e-mail d'un utilisateur spécifique, appelez
accounts.v1beta.accounts.users.getEmailPreferences
Voici un exemple de requête, où merchantId
correspond à l'ID du marchand
compte concerné par les notifications par e-mail, et emailAddress
correspond à l'adresse e-mail
de l'utilisateur qui reçoit les e-mails.
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences
Voici un exemple de réponse à un appel réussi:
{
"name": "accounts/merchantId/users/emailAddress/emailPreferences",
"newsAndTips": "OPTED_IN"
}
Pour en savoir plus sur les notifications par e-mail, consultez l'article Modifier votre compte Merchant Center préférences relatives aux e-mails.