Hintergrund
Mit der Funktion „Automatisch verknüpfte Karten/Tickets“ kannst du zusätzliche Karten/Tickets an eine Nutzer, der deine vorhandene Karte bzw. dein Ticket bereits in Google Wallet hat. Sie können auch Pre-Link-Karten/Tickets werden an eine primäre Karte bzw. ein primäres Ticket gesendet, wenn ein Nutzer die primäre Karte bzw. das primäre Ticket speichert. (Haupt-)Pass. Die automatisch verknüpfte Karte bzw. das verknüpfte Ticket wird mit der primären Karte bzw. dem Ticket gruppiert und Callout über der primären Karte bzw. dem primären Ticket, das den Nutzer darüber informiert, dass eine neue Karte bzw. ein neues Ticket verknüpft sind. Die folgenden Karten-/Tickettypen werden als primäre oder verknüpfte Karten/Tickets unterstützt:
- Veranstaltungstickets
- Bordkarte
- Fahrkarte
- Angebot
- Geschenkkarte
- Kundenkarte
- Generische Karten/Tickets
![]() |
![]() |
Primäre Karte/Ticket mit dem Callout, dass eine neue Karte bzw. ein neues Ticket hinzugefügt wurde | Neue Karte bzw. neues Ticket mit der primären Karte bzw. dem primären Ticket verknüpft |
Anwendungsfälle
Das Verknüpfen von Karten/Tickets mit einer vorhandenen Karte bzw. einem vorhandenen Ticket kann verschiedene Anwendungsfälle haben. Hier einige Beispiele:
- Verknüpfen Sie ein Angebot mit einer vorhandenen Kundenkarte.
- Verknüpfen Sie einen Essensgutschein mit einer Bordkarte oder einem Veranstaltungsticket.
- Verknüpfen Sie eine Parkkarte mit einem Veranstaltungsticket.
Überlegungen bei der Verwendung automatisch verknüpfter Karten/Tickets
- Das primäre Objekt und das verknüpfte Objekt müssen dieselbe Aussteller-ID verwenden.
- Pro primärem Objekt sind maximal 50 verknüpfte Objekte zulässig.
- Das automatische Senden verknüpfter Karten/Tickets wird nicht garantiert und berücksichtigt Best-Effort-Prinzip. Nutzer können automatisch verknüpfte Karten/Tickets deaktivieren. Wenn der Anwendungsfall und der Nutzer muss die verknüpfte Karte bzw. das verknüpfte Ticket erhalten, empfehlen wir, über einen anderen Kanal kommunizieren, um sicherzustellen, dass der Nutzer die Karte bzw. das Ticket hinzufügt.
- Aktualisierung der Richtlinien zur Fairen Nutzung von Google Wallet Anleitungen zur Verwendung von automatisch verknüpften Karten/Tickets enthalten, die eingehalten werden müssen.
Integrationsschritte
Wenn Sie bereits ein primäres Objekt erstellt haben, können Sie Schritt 1 überspringen.
- Erstelle ein Objekt eines beliebigen aufgeführten Karten-/Tickettyps. mit den erforderlichen Parametern. Dies ist das primäre Objekt.
- Erstelle ein weiteres Objekt eines beliebigen aufgeführten Karten-/Tickettyps. Das ist der verknüpftes Objekt.
- Aktualisieren Sie entweder vor oder nach dem Speichern des primären Objekts das primäre Objekt mit der ID des verknüpften Objekts in den "linkedObjectIds". .
Es ist eine minimale Nutzlast erforderlich, um die verknüpften ObjectIds auf einer primären Instanz festzulegen. übergeben. Die drei erforderlichen Parameter sind:
- ISSUERID.PRIMARY_OBJECT_ID
- ISSUERID.PRIMARY_CLASS_ID
- ISSUERID.LINKED_OBJECT_ID
Beispiel für eine JSON-Anfrage zum Hinzufügen eines verknüpften Objekts zu einem Karten-/Ticketobjekt
… { "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 Karten-/Ticketobjekt
… "state": "active", "linkedObjectIds": { "ISSUERID.LINKED_PASS_OBJECTID" } …
Erwartetes Verhalten
Nachdem Sie eine erfolgreiche Antwort erhalten haben, werden Geräte mit der Karte bzw. dem Ticket aktualisiert, das Sie aktualisiert haben. sollte die verknüpfte Karte bzw. das verknüpfte Ticket erhalten. Diese verknüpfte Karte bzw. dieses verknüpfte Ticket wird gruppiert mit die primäre Karte bzw. das primäre Ticket. Nutzer können die verknüpfte Karte bzw. das verknüpfte Ticket aufrufen, indem sie nach rechts wischen.
Ausnahmebehandlung
Mögliche Fehler können bei falscher Verwendung der API auftreten, Einschließen;
Botschaft | Grund |
---|---|
Primäres Objekt und verknüpftes Objekt haben nicht denselben Aussteller ID. | Sie können kein verknüpftes Objekt an das Objekt eines anderen Ausstellers anhängen. |
Primäres Objekt und verknüpftes Objekt verweisen auf dasselbe Objekt. | Sie können nicht dasselbe Objekt wie "linkedObject" anhängen. |
Das verknüpfte Objekt ist nicht vorhanden. | Das verknüpfte Objekt sollte bereits im Wallet eingefügt sein der API erstellen. |
Das verknüpfte Objekt hat bereits ein anderes verknüpftes Objekt. Verschachtelte Elemente können nicht hinzugefügt werden verknüpfte Objekte. | Verknüpfte Objekte dürfen kein anderes verknüpftes Objekt haben. |
Objekt ist bereits mit einem anderen Objekt verknüpft. Verschachtelte verknüpfte Elemente können nicht hinzugefügt werden Objekte. | Das primäre Objekt selbst kann kein verknüpftes Objekt sein. |
Es können keine weiteren verknüpften Objekte hinzugefügt werden, da das Limit überschritten wurde. | Das Limit von 50 verknüpften Karten/Tickets für die primäre Karte wurde erreicht übergeben. |