Ressource: OfferObject
JSON-Darstellung |
---|
{ "kind": string, "classReference": { object ( |
Felder | |
---|---|
kind |
Kennzeichnet, welche Art von Ressource dies ist. Wert: der feste String |
class |
Eine Kopie der übernommenen Felder der übergeordneten Klasse. Diese Felder werden bei einem GET-Vorgang abgerufen. |
id |
Erforderlich. Die eindeutige Kennung für ein Objekt. Diese ID muss für alle Objekte eines Ausstellers eindeutig sein. Dieser Wert sollte 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. |
class |
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 die erstere von Google ausgestellt und die zweite von Ihnen ausgewählt wird. |
version |
Verworfen |
state |
Erforderlich. Der Status des Objekts. Mit diesem Feld wird festgelegt, wie ein Objekt in der App angezeigt wird. Ein |
barcode |
Der Typ und Wert des Barcodes. |
messages[] |
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. |
valid |
Der Zeitraum, in dem dieses Objekt |
locations[] |
Hinweis: Dieses Feld wird derzeit nicht zum Auslösen von Benachrichtigungen unterstützt. |
has |
Gibt an, ob das Objekt Nutzer hat. Dieses Feld wird von der Plattform festgelegt. |
smart |
Der Wert, der für dieses Objekt über NFC an ein Smart-Bonus-zertifiziertes Terminal übertragen wird. Die Felder auf Klassenebene |
has |
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. Nur für ausgewählte Partner bestimmt. Weitere Informationen erhalten Sie vom Support. |
disable |
Gibt an, ob Benachrichtigungen explizit unterdrückt werden sollen. Wenn dieses Feld auf „wahr“ gesetzt ist, werden unabhängig vom Feld Derzeit kann dies nur für Angebote festgelegt werden. |
info |
Verworfen. Verwenden Sie stattdessen textModulesData. |
image |
Daten des Bildmoduls. Maximal werden ein Feld auf Objektebene und ein Feld auf Klassenobjektebene angezeigt. |
text |
Textmoduldaten. Wenn auch Textmoduldaten für die Klasse definiert sind, werden beide angezeigt. Es werden maximal 10 Felder des Objekts und 10 Felder der Klasse angezeigt. |
links |
Linkmoduldaten. Wenn für den Kurs auch Linkmoduldaten definiert sind, werden beide angezeigt. |
app |
Optionaler Link zu einer App oder Website, der auf der Vorderseite der Karte/des Tickets als Schaltfläche angezeigt wird. Wenn AppLinkData für das entsprechende Klassenobjekt bereitgestellt wird, wird nur das AppLinkData-Objekt angezeigt. |
rotating |
Typ und Wert des rotierenden Barcodes. |
hero |
Optionales Bannerbild, das auf der Vorderseite der Karte angezeigt wird. Ist keins vorhanden, wird das Hero-Image der Klasse angezeigt, sofern vorhanden. Wenn auch das Hero-Image des Kurses nicht vorhanden ist, wird nichts angezeigt. |
grouping |
Informationen, die steuern, wie Karten/Tickets gruppiert werden. |
pass |
Einschränkungen für das Objekt. Dazu gehört auch die Einschränkung des NFC- und Screenshot-Verhaltens. |
save |
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. |
linked |
verknüpfteObjectIds sind eine Liste weiterer Objekte wie Veranstaltungstickets, Treuepunkte, Angebote, generische, Geschenkkarten, öffentliche Verkehrsmittel und Bordkarten, die automatisch an dieses Angebotsobjekt angehängt werden sollen. Wenn ein Nutzer dieses Angebot 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. Achten Sie darauf, dass Objekte, die in „linkedObjectIds“ vorhanden sind, bereits eingefügt wurden. 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, wenn die erstere von Google herausgegeben und die zweite von Ihnen ausgewählt wird. |
notify |
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 temporär und muss bei jeder PATCH- oder UPDATE-Anfrage festgelegt werden. Andernfalls wird keine Benachrichtigung ausgelöst. |
value |
Optionale Daten zum Mehrwertmodul. Maximal zehn für das Objekt. |
Methoden |
|
---|---|
|
Fügt dem Angebotsobjekt, auf das die angegebene Objekt-ID verweist, eine Nachricht hinzu. |
|
Gibt das Angebotsobjekt mit der angegebenen Objekt-ID zurück. |
|
Ein Angebotsobjekt mit der angegebenen ID und den angegebenen Eigenschaften wird eingefügt. |
|
Gibt eine Liste aller Angebotsobjekte für eine bestimmte Aussteller-ID zurück. |
|
Aktualisiert das Angebotsobjekt, auf das durch die angegebene Objekt-ID verwiesen wird. |
|
Aktualisiert das Angebotsobjekt, auf das durch die angegebene Objekt-ID verwiesen wird. |