Attiva notifiche push

Tipi di notifiche

Aggiungi messaggio e Avvisa

Sfondo

Dopo che un utente ha aggiunto una tessera, potresti volergli inviare un messaggio relativo alla tessera e assicurarti che riceva una notifica. Se utilizzi la richiesta dell'API Add Message con un valore message_type uguale a TEXT_AND_NOTIFY, si verifica quanto segue:

  1. Un elemento "Messaggio" viene aggiunto al "retro della tessera" (noto anche come Modello dettagli) e viene inviata una notifica push agli utenti con la tessera salvata.
  2. Dopo aver toccato la notifica, l'utente apre Google Wallet davanti alla tessera (ovvero nella visualizzazione schede). Nella parte superiore dello schermo viene visualizzato un callout con un pulsante "Visualizza messaggio".
  3. Facendo clic sul callout, gli utenti verranno indirizzati al retro della tessera, dove sono evidenziati i nuovi messaggi da leggere.

Alcune considerazioni sull'invio di messaggi con notifiche agli utenti

  • Per ricevere le notifiche push relative ai messaggi, gli utenti devono aver attivato le notifiche per le tessere.
  • I messaggi possono contenere URI che rimandano al tuo sito web o alla tua app. I link ipertestuali devono rimandarvi a un sito web o un'app correlati alla tessera. È una violazione delle Norme relative all'utilizzo accettabile inviare gli utenti a link non correlati alla tessera.
  • Puoi inviare un massimo di 3 messaggi che attivano una notifica push in un periodo di 24 ore. Google potrebbe limitare la quota di invio delle notifiche push se ritiene che tu stia inviando spam ai tuoi utenti.
  • La notifica push visualizzata dagli utenti sulla schermata di blocco è controllata da Google Wallet.
  • Puoi utilizzare i metodi UPDATE o PATCH per modificare o rimuovere i dati dei messaggi utilizzando l'endpoint di classe o oggetto normale.

Passaggi per l'integrazione

Quando vuoi notificare agli utenti un nuovo messaggio del gestore aggiunto utilizzando l'API AddMessage, devi aggiornare AddMessageRequest in modo che il Message contenente il nuovo testo abbia MessageType TEXT_AND_NOTIFY anziché TEXT.

Esempio di richiesta JSON per aggiungere un messaggio e inviare una notifica in una classe di documenti di viaggio

  …
  "id": ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Class message header",
        "body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

Esempio di richiesta JSON per aggiungere un messaggio e inviare una notifica in un oggetto Passes

  …
  "id": OBJECT_ID",
  "classId": "ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Object message header",
        "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

Esempio di risposta per aggiungere un messaggio e inviare una notifica per un corso superato

  // The updated resource
  …
    {
      "kind": "walletobjects#walletObjectMessage",
      "header": "My Object message header",
      "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
      "id": "message_id",
      "messageType": "textAndNotify"
    },
  …

Gestione delle eccezioni

Eventuali tentativi di invio di una notifica più di tre volte restituiranno una risposta QuotaExceededException . Eventuali ulteriori aggiornamenti della tessera possono essere impostati utilizzando "TEXT" anziché "TEXT_AND_NOTIFY", come discusso nei passaggi di integrazione.