REST Resource: eventticketobject

Ressource: EventTicketObject

JSON-Darstellung
{
  "kind": string,
  "classReference": {
    object (EventTicketClass)
  },
  "seatInfo": {
    object (EventSeat)
  },
  "reservationInfo": {
    object (EventReservationInfo)
  },
  "ticketHolderName": string,
  "ticketNumber": string,
  "ticketType": {
    object (LocalizedString)
  },
  "faceValue": {
    object (Money)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "linkedOfferIds": [
    string
  ],
  "hexBackgroundColor": string,
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
Felder
kind
(deprecated)

string

Kennzeichnet, welche Art von Ressource dies ist. Wert: der feste String "walletobjects#eventTicketObject".

classReference

object (EventTicketClass)

Eine Kopie der übernommenen Felder der übergeordneten Klasse. Diese Felder werden bei einem GET-Vorgang abgerufen.

seatInfo

object (EventSeat)

Sitzplatzdetails für dieses Ticket.

reservationInfo

object (EventReservationInfo)

Reservierungsdetails für dieses Ticket. Dieser wird voraussichtlich auf alle Tickets aufgeteilt, die in derselben Bestellung gekauft wurden.

ticketHolderName

string

Name des Ticketinhabers, falls das Ticket einer Person zugewiesen wurde Beispiel: „Max Mustermann“ oder „Maria Muster“.

ticketNumber

string

Die Nummer des Tickets. Dies kann eine eindeutige Kennung für alle Tickets im System eines Ausstellers, alle Tickets für die Veranstaltung (z.B. XYZ1234512345) oder alle Tickets der Bestellung (1, 2, 3 usw.) sein.

ticketType

object (LocalizedString)

Der Typ des Tickets, z. B. „Erwachsener“ oder „Kind“ oder „VIP“ oder „Standard“.

faceValue

object (Money)

Der Nennbetrag des Tickets, der mit dem Wert auf der physischen Version des Tickets übereinstimmt.

groupingInfo

object (GroupingInfo)

Informationen, die steuern, wie Karten/Tickets gruppiert werden.

linkedOfferIds[]

string

Eine Liste der Angebotsobjekte, die mit diesem Veranstaltungsticket verknüpft sind. Die Angebotsobjekte müssen bereits vorhanden sein.

Angebotsobjekt-IDs müssen dem Format issuer ID entsprechen.identifier, wobei von Google ausgegeben und von dir ausgewählt wird.

hexBackgroundColor

string

Die Hintergrundfarbe der Karte. Falls nicht festgelegt, wird die Hauptfarbe des Hero-Images verwendet, und wenn kein Hero-Image festgelegt ist, wird die Hauptfarbe des Logos verwendet. Das Format ist #rrggbb, wobei rrggbb ein hexadezimales RGB-Triplet ist, z. B. #ffcc00. Du kannst auch die Kurzversion des RGB-Triplets (#rgb) verwenden, z. B. #fc0.

id

string

Erforderlich. Die eindeutige Kennung für ein Objekt. Diese ID muss für alle Objekte eines Ausstellers eindeutig sein. Dieser Wert muss das Format issuer ID haben.identifier, wobei von Google ausgegeben und von dir ausgewählt wird. Die eindeutige Kennung darf nur alphanumerische Zeichen, „.“ (Punkt), „_“ (Unterstrich) oder „-“ (Bindestriche) enthalten.

classId

string

Erforderlich. Die mit diesem Objekt verknüpfte Klasse. Die Klasse muss vom selben Typ wie dieses Objekt sein, bereits vorhanden und genehmigt sein.

Klassen-IDs müssen dem Format issuer ID entsprechen.identifier, wobei von Google ausgegeben und von dir ausgewählt wird.

version
(deprecated)

string (int64 format)

Verworfen

state

enum (State)

Erforderlich. Der Status des Objekts. Mit diesem Feld wird festgelegt, wie ein Objekt in der App angezeigt wird. Ein inactive-Objekt wird beispielsweise in den Abschnitt „Abgelaufene Karten/Tickets“ verschoben.

barcode

object (Barcode)

Der Typ und Wert des Barcodes.

messages[]

object (Message)

Ein Array von Meldungen, die in der App angezeigt werden. Alle Nutzer dieses Objekts erhalten die zugehörigen Nachrichten. Die maximale Anzahl dieser Felder ist 10.

validTimeInterval

object (TimeInterval)

Der Zeitraum, in dem dieses Objekt active ist und das Objekt verwendet werden kann. Nach Ablauf dieses Zeitraums ändert sich der Status des Objekts in expired.

locations[]
(deprecated)

object (LatLongPoint)

Hinweis: Dieses Feld wird derzeit nicht zum Auslösen von Benachrichtigungen unterstützt.

hasUsers

boolean

Gibt an, ob das Objekt Nutzer hat. Dieses Feld wird von der Plattform festgelegt.

smartTapRedemptionValue

string

Der Wert, der für dieses Objekt über NFC an ein Smart-Bonus-zertifiziertes Terminal übertragen wird. Die Felder enableSmartTap und redemptionIssuers auf Klassenebene müssen ebenfalls richtig eingerichtet sein, damit die Karte bzw. das Ticket Smart-Bonus unterstützt. Es werden nur ASCII-Zeichen unterstützt.

hasLinkedDevice

boolean

Gibt an, ob dieses Objekt derzeit mit einem einzelnen Gerät verknüpft ist. Dieses Feld wird von der Plattform festgelegt, wenn ein Nutzer das Objekt speichert und es mit seinem Gerät verknüpft. Nur für ausgewählte Partner bestimmt. Weitere Informationen erhalten Sie vom Support.

disableExpirationNotification

boolean

Gibt an, ob Benachrichtigungen explizit unterdrückt werden sollen. Wenn dieses Feld auf „true“ gesetzt ist, werden Benachrichtigungen zu Ablaufdaten an den Nutzer unabhängig vom Feld messages unterdrückt. Standardmäßig ist dieses Feld auf „false“ gesetzt.

Derzeit kann dies nur für Angebote festgelegt werden.

infoModuleData

object (InfoModuleData)

Verworfen. Verwenden Sie stattdessen „textModulesData“.

imageModulesData[]

object (ImageModuleData)

Daten des Bildmoduls. Maximal werden ein Feld auf Objektebene und ein Feld auf Klassenobjektebene angezeigt.

textModulesData[]

object (TextModuleData)

Textmoduldaten. Wenn für den Kurs auch Textmoduldaten definiert sind, werden beide angezeigt. Es werden maximal 10 Felder des Objekts und 10 Felder der Klasse angezeigt.

rotatingBarcode

object (RotatingBarcode)

Typ und Wert des rotierenden Barcodes.

heroImage

object (Image)

Optionales Bannerbild, das auf der Vorderseite der Karte angezeigt wird Ist keins vorhanden, wird gegebenenfalls das Hero-Image des Kurses angezeigt. Wenn auch das Hero-Image des Kurses nicht vorhanden ist, wird nichts angezeigt.

passConstraints

object (PassConstraints)

Übergeben Sie die Einschränkungen für das Objekt. Dazu gehört auch das Einschränken von NFC- und Screenshot-Verhalten.

saveRestrictions

object (SaveRestrictions)

Einschränkungen für das Objekt, das überprüft werden muss, bevor der Nutzer versucht, die Karte bzw. das Ticket zu speichern. Diese Einschränkungen gelten nur während der Speicherzeit. Wenn sich die Einschränkungen ändern, nachdem ein Nutzer die Karte bzw. das Ticket gespeichert hat, werden die neuen Einschränkungen nicht auf eine bereits gespeicherte Karte bzw. ein bereits gespeichertes Ticket angewendet.

linkedObjectIds[]

string

„linkedObjectIds“ ist eine Liste anderer Objekte wie Veranstaltungstickets, Kundenkarten, Angebote, generische Karten/Tickets, Geschenkkarten, Fahrkarten und Bordkarten, die automatisch an dieses Veranstaltungsticketobjekt angehängt werden sollen. Wenn ein Nutzer dieses Veranstaltungsticket gespeichert hat, werden diese verknüpften Objekt-IDs automatisch an die Wallet des Nutzers gesendet, es sei denn, er hat die Einstellung deaktiviert, um solche verknüpften Karten/Tickets zu erhalten.

Stellen Sie sicher, dass die in verknüpftenObjectIds vorhandenen Objekte bereits eingefügt sind. Andernfalls schlagen Aufrufe fehl. Nach der Verknüpfung können die verknüpften Objekte nicht mehr getrennt werden. Sie können keine Objekte verknüpfen, die einem anderen Aussteller gehören. Die Anzahl der Objekte, die mit einem einzelnen Objekt verknüpft werden können, ist begrenzt. Wenn das Limit erreicht ist, werden neue verknüpfte Objekte im Anruf stumm ignoriert.

Objekt-IDs müssen dem Format issuer ID entsprechen.identifier, wobei von Google ausgegeben und von dir ausgewählt wird.

notifyPreference

enum (NotificationSettingsForUpdates)

Gibt an, ob Feldaktualisierungen für dieses Objekt Benachrichtigungen auslösen sollen. Wenn diese Option auf NOTIFY gesetzt ist, versuchen wir, eine Benachrichtigung über die Aktualisierung eines Felds an die Nutzer auszulösen. Diese Benachrichtigungen werden nur an Nutzer gesendet, wenn das Feld auf einer Zulassungsliste steht. Wenn „DO_NOT_NOTIFY“ oder „NOTIFICATION_SETTINGS_UNSPECIFIED“ festgelegt ist, wird keine Benachrichtigung ausgelöst. Diese Einstellung ist sitzungsspezifisch und muss bei jeder PATCH- oder UPDATE-Anfrage festgelegt werden. Andernfalls wird keine Benachrichtigung ausgelöst.

valueAddedModuleData[]

object (ValueAddedModuleData)

Optionale Moduldaten mit Mehrwert. Maximal zehn für das Objekt.

EventSeat

JSON-Darstellung
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
Felder
kind
(deprecated)

string

Gibt an, um welche Art von Ressource es sich handelt. Wert: der feste String "walletobjects#eventSeat".

seat

object (LocalizedString)

Die Sitzplatznummer, z. B. „1“, „2“, „3“ oder eine andere Sitzplatzkennzeichnung.

Dieses Feld kann lokalisiert werden, sodass Sie Wörter übersetzen oder verschiedene Alphabete für die Zeichen in einer ID verwenden können.

row

object (LocalizedString)

Die Sitzzeile, z. B. „1“, „E“, „BB“ oder „A5“.

Dieses Feld kann lokalisiert werden, sodass Sie Wörter übersetzen oder verschiedene Alphabete für die Zeichen in einer ID verwenden können.

section

object (LocalizedString)

Der Bereich des Sitzplatzes, z. B. „121“.

Dieses Feld ist lokalisierbar, sodass Sie Wörter übersetzen oder verschiedene Alphabete für die Zeichen in einer Kennung verwenden können.

gate

object (LocalizedString)

Das Gate, das der Ticketinhaber betreten muss, um zu seinem Sitzplatz zu gelangen, z. B. „A“ oder „West“.

Dieses Feld ist lokalisierbar, sodass Sie Wörter übersetzen oder verschiedene Alphabete für die Zeichen in einer Kennung verwenden können.

EventReservationInfo

JSON-Darstellung
{
  "kind": string,
  "confirmationCode": string
}
Felder
kind
(deprecated)

string

Gibt an, um welche Art von Ressource es sich handelt. Wert: der feste String "walletobjects#eventReservationInfo".

confirmationCode

string

Der Bestätigungscode der Terminreservierung. Diese kann auch in Form einer „Bestellnummer“, „Bestätigungsnummer“, „Reservierungsnummer“ oder einer äquivalenten Nummer angegeben werden.

Methoden

addmessage

Fügt dem Veranstaltungsticketobjekt, auf das die angegebene Objekt-ID verweist, eine Nachricht hinzu.

get

Gibt das Ereignisticketobjekt mit der angegebenen Objekt-ID zurück.

insert

Ein Objekt vom Typ „Ticket“ mit der angegebenen ID und den angegebenen Eigenschaften wird eingefügt.

list

Gibt eine Liste aller Veranstaltungsticketobjekte für eine bestimmte Aussteller-ID zurück.

modifylinkedofferobjects

Ändert verknüpfte Angebotsobjekte für das Veranstaltungsticketobjekt mit der angegebenen ID.

patch

Aktualisiert das Veranstaltungsticketobjekt, auf das die angegebene Objekt-ID verweist.

update

Aktualisiert das Veranstaltungsticketobjekt, auf das die angegebene Objekt-ID verweist.