Gestisci le notifiche via email di Merchant Center

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 risorsa User.
• 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.