Automatisch verknüpfte Karten/Tickets

Hintergrund

Mit der Funktion „Automatisch verknüpfte Karten/Tickets“ können Sie einem Nutzer, der bereits Ihre vorhandene Karte/Ihr vorhandenes Ticket in Google Wallet hat, zusätzliche Karten/Tickets senden. Sie können auch Karten und Tickets mit einer primären (Haupt-)Karte oder einem ‑Ticket verknüpfen, wenn ein Nutzer diese speichert. Die automatisch verknüpfte Karte / das automatisch verknüpfte Ticket wird mit der primären Karte / dem primären Ticket gruppiert. Über der primären Karte / dem primären Ticket wird ein Hinweis eingeblendet, dass eine neue Karte / ein neues Ticket verknüpft wurde. Die folgenden Arten von Karten werden als primäre oder verknüpfte Karten unterstützt:

• Veranstaltungstickets
• Bordkarte
• Fahrkarte
• Angebot
• Geschenkkarte
• Kundenkarte
• Generische Karte/generisches Ticket

Primäre Karte/primäres Ticket mit dem Hinweis, dass eine neue Karte/ein neues Ticket hinzugefügt wurde	Neue Karte/neues Ticket mit der primären Karte/dem primären Ticket verknüpft

Anwendungsfälle

Es gibt verschiedene Anwendungsfälle für das Verknüpfen von Karten/Tickets mit einer vorhandenen Karte/einem vorhandenen Ticket. Beispiele:

• Angebot mit einer vorhandenen Kundenkarte verknüpfen
• Verknüpfen Sie einen Essensgutschein mit einer Bordkarte oder einem Veranstaltungsticket.
• Parkkarte mit einem Veranstaltungsticket verknüpfen

Hinweise zur Verwendung automatisch verknüpfter Karten/Tickets

• Für das primäre Objekt und das verknüpfte Objekt muss dieselbe issuerId verwendet werden.
• Pro primärem Objekt sind maximal 50 verknüpfte Objekte zulässig.
• Das automatische Pushen verknüpfter Karten ist nicht garantiert und wird nach dem Best-Effort-Prinzip durchgeführt. Nutzer können den Empfang automatisch verknüpfter Karten/Tickets deaktivieren. Wenn der Anwendungsfall kritisch ist und der Nutzer die verknüpfte Karte erhalten muss, empfehlen wir, über einen anderen Kanal zu kommunizieren, um sicherzustellen, dass der Nutzer die Karte hinzufügt.
• Die Nutzungsrichtlinien für Google Wallet wurden aktualisiert und enthalten jetzt Richtlinien zur Verwendung von automatisch verknüpften Karten/Tickets, die eingehalten werden müssen.

Integrationsschritte

Wenn Sie bereits ein primary-Objekt erstellt haben, können Sie Schritt 1 überspringen.

1. Erstellen Sie ein Objekt für einen beliebigen Kartentyp, der mit den erforderlichen Parametern aufgeführt ist. Dies ist das primäre Objekt.
2. Erstellen Sie ein weiteres Objekt eines beliebigen aufgeführten Karten-/Ticketyps. Dies ist das verknüpfte Objekt.
3. Aktualisieren Sie das primäre Objekt entweder vor oder nach dem Speichern mit der ID des verknüpften Objekts im Parameter „linkedObjectIds“.

Es ist eine Mindestnutzlast erforderlich, um die linkedObjectIds für eine primäre Karte festzulegen. Die drei erforderlichen Parameter sind:

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

Beispiel für eine JSON-Anfrage zum Hinzufügen eines verknüpften Objekts zu einem Pass-Objekt

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

Beispiel für eine JSON-Antwort nach dem Verknüpfen eines Objekts mit einem Pass-Objekt

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

Erwartetes Verhalten

Nachdem Sie eine erfolgreiche Antwort erhalten haben, sollten Geräte mit dem aktualisierten Ticket das verknüpfte Ticket erhalten. Diese verknüpfte Karte wird mit der primären Karte gruppiert. Nutzer können die verknüpfte Karte oder das verknüpfte Ticket aufrufen, indem sie nach rechts wischen.

Ausnahmebehandlung

Bei einer falschen Verwendung der API können folgende Fehler auftreten: