REST Resource: offerobject

Ressource: OfferObject

JSON-Darstellung
{
  "kind": string,
  "classReference": {
    object (OfferClass)
  },
  "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)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  }
}
Felder
kind
(deprecated)

string

Gibt an, welche Art von Ressource dies ist. Wert: der feste String "walletobjects#offerObject".

classReference

object (OfferClass)

Eine Kopie der übernommenen Felder der übergeordneten Klasse. Diese Felder werden während eines GET-Vorgangs abgerufen.

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 ersteres von Google ausgegeben und letzter von Ihnen ausgewählt wird. Die eindeutige Kennung darf nur alphanumerische Zeichen, „.“, „_“ oder „-“ enthalten.

classId

string

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

Klassen-IDs müssen das Format issuer ID haben.identifier, wobei ersteres von Google ausgegeben und letzter von Ihnen ausgewählt wird.

version
(deprecated)

string (int64 format)

Eingestellte Funktionen

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)

Typ und Wert des Barcodes.

messages[]

object (Message)

Ein Array von Nachrichten, die in der App angezeigt werden. Alle Nutzer dieses Objekts erhalten die zugehörigen Nachrichten. Es sind maximal 10 Felder zulässig.

validTimeInterval

object (TimeInterval)

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

locations[]

object (LatLongPoint)

Hinweis: Dieses Feld wird derzeit nicht zum Auslösen von Geo-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. Auch die Felder auf Kursebene enableSmartTap und redemptionIssuers müssen korrekt 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 mit seinem Gerät verknüpft. Für die Verwendung durch ausgewählte Partner vorgesehen. Weitere Informationen erhalten Sie beim Support.

disableExpirationNotification

boolean

Gibt an, ob Benachrichtigungen explizit unterdrückt werden sollen. Wenn dieses Feld auf „true“ gesetzt ist, werden unabhängig vom Feld „messages“ Ablaufbenachrichtigungen an den Nutzer unterdrückt. Die Standardeinstellung für dieses Feld ist „false“.

Derzeit kann dies nur für Angebote festgelegt werden.

infoModuleData

object (InfoModuleData)

Veraltet. Verwenden Sie stattdessen „textModulesData“.

imageModulesData[]

object (ImageModuleData)

Bildmoduldaten. Es werden maximal 1 Feld auf Objektebene und 1 Feld auf Klassenobjektebene angezeigt.

textModulesData[]

object (TextModuleData)

Textmoduldaten. Wenn für die Klasse auch Textmoduldaten definiert sind, werden beide angezeigt. Es werden maximal 10 Felder vom Objekt und 10 Felder aus der Klasse angezeigt.

rotatingBarcode

object (RotatingBarcode)

Typ und Wert des rotierenden Barcodes.

heroImage

object (Image)

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

groupingInfo

object (GroupingInfo)

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

passConstraints

object (PassConstraints)

Übergeben Sie die Einschränkungen für das Objekt. Einschließlich der Beschränkung des NFC- und Screenshot-Verhaltens.

Methoden

addmessage

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

get

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

insert

Fügt ein Angebotsobjekt mit der angegebenen ID und Eigenschaften ein.

list

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

patch

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

update

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