Gestisci le notifiche via email di Merchant Center

Questa guida spiega come utilizzare la risorsa EmailPreferences per gestire le notifiche email di Merchant Center e vedere quali tipi di email riceve il users del tuo account. Per l'elenco completo dei tipi di notifiche via email, consulta il riferimento EmailPreferences.

Puoi utilizzare l'API Merchant solo per gestire le notifiche via email per gli account in cui sei aggiunto come utente.

Per visualizzare o aggiornare le notifiche via email, devi disporre dei seguenti valori:

• L'indirizzo email dell'utente che riceve le email. Puoi trovare il suo indirizzo email nel campo name della risorsa User.
• L'ID commerciante dell'account per cui iniziare o interrompere la ricezione di 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 accounts.v1beta.accounts.users.updateEmailPreference con l'merchantId dell'account e l'indirizzo email dell'utente.

Utilizza i seguenti valori per controllare le notifiche via email che l'utente riceve:

• OPTED_IN: per ricevere notifiche via email per l'account.
• OPTED_OUT: non riceverai notifiche via email per l'account.

Di seguito è riportata una richiesta di esempio per disattivare le notifiche via email per un account merchant specifico:

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

{
  "newsAndTips": "OPTED_OUT"
}

Visualizzare le notifiche esistenti

Per visualizzare le impostazioni di notifica via email correnti per un utente specifico, chiama accounts.v1beta.accounts.users.getEmailPreferences.

Ecco una richiesta di esempio, in cui merchantId è l'ID commerciante dell'account per cui sono state impostate le 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

Ecco un esempio di risposta di una chiamata andata a buon fine:

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

Per ulteriori informazioni sulle notifiche via email, consulta Modificare le preferenze email di Merchant Center.