REST Resource: genericobject

Ressource: GenericObject

Generisches Objekt

JSON-Darstellung 
{
  "genericType": enum (GenericType),
  "cardTitle": {
    object (LocalizedString)
  },
  "subheader": {
    object (LocalizedString)
  },
  "header": {
    object (LocalizedString)
  },
  "logo": {
    object (Image)
  },
  "hexBackgroundColor": string,
  "notifications": {
    object (Notifications)
  },
  "id": string,
  "classId": string,
  "barcode": {
    object (Barcode)
  },
  "heroImage": {
    object (Image)
  },
  "validTimeInterval": {
    object (TimeInterval)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "smartTapRedemptionValue": string,
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "state": enum (State),
  "hasUsers": boolean,
  "messages": [
    {
      object (Message)
    }
  ],
  "passConstraints": {
    object (PassConstraints)
  },
  "wideLogo": {
    object (Image)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ],
  "linkedObjectIds": [
    string
  ]
}
Felder
genericType

enum (GenericType)

Gibt an, zu welchem GenericType die Karte gehört.
cardTitle

object (LocalizedString)

Erforderlich. Die Überschrift der Karte bzw. des Tickets. Das ist in der Regel der Name des Unternehmens, z. B. „XXX Fitnessstudio“ oder „AAA-Versicherung“. Dieses Feld ist erforderlich und wird in der Kopfzeile ganz oben auf der Karte/dem Ticket angezeigt.
subheader

object (LocalizedString)

Das Titellabel der Karte/des Tickets, z. B. der Ort, an dem die Karte/das Ticket verwendet werden kann. Wird in der Detailansicht der Karte/des Tickets direkt über dem Titel in der Titelzeile angezeigt.
header

object (LocalizedString)

Erforderlich. Der Titel der Karte/des Tickets, z. B. „Gutschein für 50% Rabatt“, „Bibliotheksausweis“ oder „Gutschein“. Dieses Feld ist erforderlich und wird in der Titelzeile der Detailansicht der Karte bzw. des Tickets angezeigt.
hexBackgroundColor

string

Die Hintergrundfarbe der Karte bzw. des Tickets. Falls nicht festgelegt, wird die Hauptfarbe des Hero-Images verwendet, und wenn kein Hero-Image festgelegt ist, wird die Hauptfarbe des Logos verwendet. Ist auch das Logo nicht festgelegt, wird eine Farbe von Google ausgewählt.
notifications

object (Notifications)

Die für dieses Objekt aktivierten Benachrichtigungseinstellungen.
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 issuerID.identifier haben, bei dem issuerID von Google ausgegeben und identifier von dir ausgewählt wird. Die eindeutige Kennung kann nur alphanumerische Zeichen, ., _ oder - 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.

Kurs-IDs müssen das Format issuerID.identifier haben, bei dem issuerID von Google ausgegeben und identifier von dir ausgewählt wird.
barcode

object (Barcode)

Der Typ und Wert des Barcodes. Wenn die Karte bzw. das Ticket keinen Barcode hat, kann der Aussteller „barcode.alternative_text“ festlegen und nur diesen anzeigen.
heroImage

object (Image)

Bannerbild, das, falls vorhanden, auf der Vorderseite der Karte angezeigt wird Das Bild wird mit 100% der Breite angezeigt.
validTimeInterval

object (TimeInterval)

Der Zeitraum, in dem dieses Objekt als gültig oder verwendbar gilt. Nach Ablauf des Zeitraums gilt das Objekt als abgelaufen, was sich auf die Darstellung auf den Geräten der Nutzer auswirkt.
imageModulesData[]

object (ImageModuleData)

Daten des Bildmoduls. Wenn beide festgelegt sind, wird nur eines der Bilder von der Klassen- und eines von der Objektebene gerendert.
textModulesData[]

object (TextModuleData)

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

object (GroupingInfo)

Informationen, die steuern, wie Karten/Tickets gruppiert werden.
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.
rotatingBarcode

object (RotatingBarcode)

Die Einstellungen/Details für den rotierenden Barcode.
state

enum (State)

Der Status des Objekts. Mit diesem Feld wird festgelegt, wie ein Objekt in der App angezeigt wird. Beispielsweise wird ein inactive-Objekt in den Abschnitt „Abgelaufene Karten/Tickets“ verschoben. Wenn dieser Wert nicht angegeben ist, wird das Objekt als ACTIVE betrachtet.
hasUsers

boolean

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

object (Message)

Eine Reihe von Nachrichten, die in der App angezeigt werden. Alle Nutzer dieses Objekts erhalten die zugehörigen Nachrichten. Die maximale Anzahl dieser Felder ist 10.
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, die überprüft werden müssen, 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.
valueAddedModuleData[]

object (ValueAddedModuleData)

Optionale Daten zum Mehrwertmodul. Maximal zehn für das Objekt.
linkedObjectIds[]

string

„linkedObjectIds“ ist eine Liste anderer Objekte wie Veranstaltungstickets, Kundenkarten, Angebote, generische Objekte, Geschenkkarten, Fahrkarten und Bordkarten, die automatisch an dieses generische Objekt angehängt werden sollen. Wenn ein Nutzer diese generische Karte gespeichert hätte, werden diese verknüpften ObjectIds automatisch an das Wallet des Nutzers gesendet, es sei denn, er hat die Einstellung zum Erhalt solcher verknüpften Karten/Tickets deaktiviert.

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.

GenericType

Der Typ der generischen Karte.

Enums
GENERIC_TYPE_UNSPECIFIED Nicht angegebener generischer Typ.
GENERIC_SEASON_PASS Saisonpass
GENERIC_UTILITY_BILLS Rechnungen von Versorgungsunternehmen
GENERIC_PARKING_PASS Parkschein
GENERIC_VOUCHER Gutschein
GENERIC_GYM_MEMBERSHIP Mitgliedskarten für Fitnessstudios
GENERIC_LIBRARY_MEMBERSHIP Bibliotheksausweise
GENERIC_RESERVATIONS Reservierungen
GENERIC_AUTO_INSURANCE Kfz-Versicherungskarten
GENERIC_HOME_INSURANCE Wohngebäudeversicherungskarten
GENERIC_ENTRY_TICKET Eintrittskarten
GENERIC_RECEIPT Belege
GENERIC_LOYALTY_CARD Kundenkarten Es wird empfohlen, anstelle dieses generischen Typs einen speziellen Kartentyp für das Treuepunkteprogramm zu verwenden. Ein spezieller Kartentyp für Kundenkarten bietet mehr Funktionen als ein generischer Kartentyp.
GENERIC_OTHER Anderer Typ

Benachrichtigungen

Gibt an, ob für das Objekt Benachrichtigungen aktiviert sein müssen. Es wird nur eine von ExpiryNotification/UpcomingNotification unterstützt. expiryNotification hat Vorrang vor upcomingNotification. Wenn expiryNotification festgelegt ist, wird das Feld upcomingNotification ignoriert.

JSON-Darstellung 
{
  "expiryNotification": {
    object (ExpiryNotification)
  },
  "upcomingNotification": {
    object (UpcomingNotification)
  }
}
Felder
expiryNotification

object (ExpiryNotification)

Eine Benachrichtigung wird zu einer bestimmten Zeit vor Ablauf der Karte ausgelöst.
upcomingNotification

object (UpcomingNotification)

Zu einer bestimmten Zeit wird eine Benachrichtigung ausgelöst, bevor die Karte verwendet werden kann.

ExpiryNotification

Gibt an, dass der Aussteller möchte, dass Google Wallet 2 Tage vor Ablauf der Karte Ablaufbenachrichtigungen sendet.

JSON-Darstellung 
{
  "enableNotification": boolean
}
Felder
enableNotification

boolean

Gibt an, ob für das Objekt die Ablaufbenachrichtigung aktiviert sein muss.

UpcomingNotification

Gibt an, dass der Aussteller möchte, dass Google Wallet 1 Tag vor Gültigkeitsbeginn der Karte eine Benachrichtigung sendet.

JSON-Darstellung 
{
  "enableNotification": boolean
}
Felder
enableNotification

boolean

Gibt an, ob für das Objekt die Benachrichtigung über anstehende Termine aktiviert sein muss.

Methoden

addmessage

 Fügt dem generischen Objekt, auf das durch die angegebene Objekt-ID verwiesen wird, eine Nachricht hinzu.

get

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

insert

 Fügt ein generisches Objekt mit der angegebenen ID und den angegebenen Eigenschaften ein.

list

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

patch

 Aktualisiert das generische Objekt, auf das durch die angegebene Objekt-ID verwiesen wird.

update

 Aktualisiert das generische Objekt, auf das von der angegebenen Objekt-ID verwiesen wird.