Questa guida spiega come utilizzare la risorsa EmailPreferences
per gestire le notifiche via email di Merchant Center e scoprire quali tipi di email ricevono users
i tuoi account. Per l'elenco completo dei tipi di notifiche via email, consulta la documentazione di riferimento di EmailPreferences
.
Puoi utilizzare l'API Merchant Center solo per gestire le notifiche email per gli account in cui sei stato aggiunto come utente.
Per visualizzare o aggiornare le notifiche via email, devi avere i seguenti valori:
- L'indirizzo email dell'utente che riceve le email. Puoi trovare l'indirizzo email nel campo
name
della risorsaUser
. - L'ID commerciante dell'account per cui attivare o disattivare la ricezione delle email. Se l'account commerciante è un account avanzato e l'utente ha accesso all'account avanzato, utilizza l'ID commerciante dell'account avanzato.
Attivare o disattivare le notifiche
Per aggiornare le impostazioni di notifica via email per un account commerciante specifico, chiama il numero
accounts.v1beta.accounts.users.updateEmailPreference
utilizzando i dati merchantId
dell'account e l'indirizzo email dell'utente.
Utilizza i valori seguenti per controllare le notifiche email ricevute dall'utente:
OPTED_IN
: ricevi notifiche via email per l'account.OPTED_OUT
: non ricevere notifiche via email relative all'account.
Ecco un esempio di richiesta per disattivare le notifiche via email di un utente per un account commerciante specifico:
PATCH https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences
{
"newsAndTips": "OPTED_OUT"
}
Visualizza notifiche esistenti
Per visualizzare le impostazioni di notifica via email correnti per un utente specifico, chiama il numero
accounts.v1beta.accounts.users.getEmailPreferences
.
Ecco una richiesta di esempio, in cui merchantId
è l'ID commerciante
dell'account oggetto delle notifiche via email e emailAddress
è l'indirizzo
email dell'utente che riceve le email.
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences
Di seguito è riportato un esempio di risposta da una chiamata riuscita:
{
"name": "accounts/merchantId/users/emailAddress/emailPreferences",
"newsAndTips": "OPTED_IN"
}
Per ulteriori informazioni sulle notifiche via email, consulta l'articolo Modificare le preferenze email di Merchant Center.