Attiva notifiche push

Tipi di notifiche

Aggiungi messaggio e notifica

Sfondo

Dopo che un utente ha aggiunto una tessera, puoi inviargli un messaggio relativo alla superato e assicurarsi di ricevere una notifica al riguardo. Utilizza l' API Add Message richiesta con un valore message_type uguale a TEXT_AND_NOTIFY si verifica quanto segue:

  1. Un "Messaggio" l'elemento viene aggiunto al "back of pass" (ovvero Dettagli modello) e viene inviata una notifica push agli utenti che hanno salvato la tessera.
  2. Quando l'utente tocca la notifica, apre Google Wallet davanti al la tessera (ovvero visualizzazione schede) e l'utente vedrà un callout nella parte superiore schermata con un messaggio "Visualizza messaggio" .
  3. Facendo clic sul callout, gli utenti verranno indirizzati al retro della tessera, dove i nuovi i messaggi da leggere vengono evidenziati.

Alcune considerazioni sull'invio di messaggi con notifiche agli utenti

  • Per poter ricevere la tessera, gli utenti devono avere attivato le notifiche Notifiche push relative ai messaggi.
  • I messaggi possono contenere URI del tuo sito web o della tua app. I link ipertestuali devono essere sito web o app correlati alla tessera. Si tratta di una violazione delle Norme di utilizzo accettabile per indirizzare 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 tua quota di recapito di notifiche push se ritiene che tu stia inviando spam ai tuoi utenti.
  • La notifica push che gli utenti vedono nella schermata di blocco è controllata da Google Portafoglio.
  • Puoi usare il pulsante AGGIORNA o PATCH per modificare o rimuovere i dati dei messaggi utilizzando la classe o l'oggetto normale endpoint.

Passaggi per l'integrazione

Quando vuoi informare gli utenti dell'aggiunta di un nuovo messaggio dell'emittente utilizzando API AddMessage, dovrai aggiornare AddMessageRequest in modo che il campo Messaggio che contiene il nuovo testo, ha il valore MessageType TEXT_AND_NOTIFY anziché TEXT.

Esempio di richiesta JSON di aggiungere un messaggio e inviare una notifica in una classe di pass

  …
  "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 una classe di accesso

  // 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

Qualsiasi tentativo di notifica per più di 3 volte produrrà un Risposta QuotaExceededException . Eventuali ulteriori aggiornamenti alle può essere impostata utilizzando "TEXT" anziché "TEXT_AND_NOTIFY" come descritto nella sezione Passaggi.