Push-Benachrichtigungen auslösen

Benachrichtigungstypen

„Nachricht hinzufügen“ und „Benachrichtigen“ hinzufügen

Hintergrund

Nachdem ein Nutzer eine Karte bzw. ein Ticket hinzugefügt hat, kannst du ihm eine Nachricht dazu senden, damit er darüber informiert wird. Wenn Sie die Add Message API-Anfrage mit einer message_type von TEXT_AND_NOTIFY verwenden, geschieht Folgendes:

  1. Dem „Rückseite der Karte/des Tickets“ (Details-Vorlage) wird der Artikel „Nachricht“ hinzugefügt und eine Push-Benachrichtigung wird an Nutzer gesendet, die die Karte bzw. das Ticket gespeichert haben.
  2. Wenn der Nutzer auf die Benachrichtigung tippt, wird Google Wallet im Vordergrund der Karte bzw. des Tickets geöffnet (Kartenansicht). Oben auf dem Bildschirm wird dem Nutzer ein Hinweis mit der Schaltfläche „Nachricht ansehen“ angezeigt.
  3. Wenn Nutzer auf das Callout klicken, werden sie zur Rückseite der Karte bzw. des Tickets geleitet. Dort werden neue ungelesene Nachrichten hervorgehoben.

Hinweise zum Senden von Nachrichten mit Benachrichtigungen an Nutzer

  • Nutzer müssen Benachrichtigungen für ihre Karten/Tickets aktiviert haben, um Push-Benachrichtigungen zu Nachrichten zu erhalten.
  • Nachrichten können URIs zu Ihrer Website oder App enthalten. Hyperlinks müssen zu einer Website oder App führen, die mit der Karte bzw. dem Ticket verknüpft ist. Es verstößt gegen die Richtlinien zur Fairen Nutzung, Nutzer zu Links zu leiten, die keinen Bezug zum Ticket haben.
  • Sie können innerhalb von 24 Stunden maximal drei Nachrichten senden, die eine Push-Benachrichtigung auslösen. Google kann Ihr Kontingent für die Zustellung von Push-Benachrichtigungen drosseln, wenn Sie Ihre Nutzer mit Spam belästigen.
  • Die Push-Benachrichtigungen, die Nutzer auf dem Sperrbildschirm sehen, werden von Google Wallet gesteuert.
  • Mit den Methoden UPDATE oder PATCH können Sie Nachrichtendaten über den regulären Klassen- oder Objektendpunkt bearbeiten oder entfernen.

Integrationsschritte

Wenn Sie Nutzer über eine neue Mitteilung des Ausstellers benachrichtigen möchten, die mit der AddMessage API hinzugefügt wurde, müssen Sie die AddMessageRequest so aktualisieren, dass die Message, die Ihren neuen Text enthält, die MessageType TEXT_AND_NOTIFY anstelle von TEXT hat.

Beispiel für eine JSON-Anfrage zum Hinzufügen einer Nachricht und zum Senden einer Benachrichtigung in einer Karten-/Ticketklasse

  …
  "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"
    },
  …

Beispiel für eine JSON-Anfrage zum Hinzufügen einer Nachricht und zum Senden einer Benachrichtigung in einem Karten-/Ticketobjekt

  …
  "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"
    },
  …

Beispiel für eine Antwort, um eine Nachricht hinzuzufügen und für eine Karten-/Ticketkategorie zu benachrichtigen

  // 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"
    },
  …

Ausnahmebehandlung

Bei mehr als drei Benachrichtigungen wird die Antwort QuotaExceededException zurückgegeben. Alle weiteren Aktualisierungen des Tickets können mit „TEXT“ anstelle von „TEXT_AND_NOTIFY“ festgelegt werden, wie in den Schritten zur Integration beschrieben.