Ressource: GiftCardClass
JSON-Darstellung |
---|
{ "kind": string, "merchantName": string, "programLogo": { object ( |
Felder | |
---|---|
kind |
Gibt an, um welche Art von Ressource es sich handelt. Wert: der feste String |
merchant |
Händlername, z. B. „Adams Bekleidung“. In der App wird nach den ersten 20 Zeichen möglicherweise ein Auslassungspunkt angezeigt, damit der vollständige String auf kleineren Displays angezeigt wird. |
program |
Das Logo des Geschenkkartenprogramms oder des Unternehmens. Dieses Logo wird sowohl in der Detailansicht als auch in der Listenansicht der App angezeigt. |
pin |
Das Label, das für die PIN angezeigt werden soll, z. B. „4-stellige PIN“. |
event |
Das Label, das für die Ereignisnummer angezeigt werden soll, z. B. „Zielereignis Nr.“ |
allow |
Gibt an, ob der Händler die Einlösung von Geschenkkarten per Barcode unterstützt. Wenn diese Option aktiviert ist, wird in der App auf dem Bildschirm „Geschenkkartendetails“ ein Barcode für die Geschenkkarte angezeigt. Wenn „false“ festgelegt ist, wird kein Barcode angezeigt. |
localized |
Übersetzte Strings für den Händlernamen. In der App wird nach den ersten 20 Zeichen möglicherweise ein Auslassungspunkt angezeigt, damit der vollständige String auf kleineren Displays angezeigt wird. |
localized |
Übersetzte Strings für das Label der Markierung. |
localized |
Übersetzte Strings für das Ereignisnummernlabel. |
card |
Das Label, das für die Kartennummer angezeigt werden soll, z. B. „Kartennummer“. |
localized |
Übersetzte Strings für das Kartennummernlabel. |
class |
Vorlageninformationen dazu, wie der Kurs angezeigt werden soll. Wenn diese Einstellung nicht festgelegt ist, verwendet Google standardmäßig einen Satz von Feldern. |
id |
Erforderlich. Die eindeutige Kennung einer Klasse. Diese ID muss für alle Klassen eines Ausstellers eindeutig sein. Dieser Wert muss das Format issuer ID haben.identifier, wobei die erstere von Google ausgestellt und die zweite von Ihnen ausgewählt wird. Die eindeutige Kennung darf nur alphanumerische Zeichen, „.“ (Punkt), „_“ (Unterstrich) oder „-“ (Bindestriche) enthalten. |
version |
Verworfen |
issuer |
Erforderlich. Der Name des Ausstellers. Die empfohlene maximale Länge ist 20 Zeichen, damit der vollständige String auf kleineren Displays angezeigt wird. |
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. |
allowMultipleUsersPerObject |
Verworfen. Verwenden Sie stattdessen |
homepage |
Der URI der Startseite Ihrer Anwendung. Wenn Sie den URI in dieses Feld einfügen, wird genau dasselbe Verhalten wie beim Einfügen eines URI in „linksModuleData“ ausgelöst. Wenn ein Objekt gerendert wird, wird im Bereich „linksModuleData“ des Objekts ein Link zur Startseite angezeigt. |
locations[] |
Hinweis: Dieses Feld wird derzeit nicht zum Auslösen von Benachrichtigungen unterstützt. |
review |
Erforderlich. Der Status des Kurses. Dieses Feld kann mit den API-Aufrufen „insert“, „patch“ oder „update“ auf „ Wenn der Kurs noch in der Entwicklungsphase ist, sollte dieses Feld auf Legen Sie dieses Feld auf Wenn Sie eine bereits vorhandene |
review |
Die Rezensionskommentare, die von der Plattform festgelegt werden, wenn ein Kurs als |
infoModuleData |
Verworfen. Verwenden Sie stattdessen textModulesData. |
image |
Daten des Bildmoduls. Maximal werden ein Feld auf Objektebene und ein Feld auf Klassenobjektebene angezeigt. |
text |
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. |
links |
Linkmoduldaten. Wenn für das Objekt auch Linkmoduldaten definiert sind, werden beide angezeigt. |
redemption |
Gibt an, welche Einlösungsaussteller die Karte bzw. das Ticket über Smart-Bonus einlösen können. Einlösungsaussteller werden anhand ihrer Aussteller-ID identifiziert. Für Aussteller von Gutscheinen muss mindestens ein Smart Tap-Schlüssel konfiguriert sein. Die Felder |
country |
Der Ländercode, der zum Anzeigen des Landes der Karte verwendet wird, wenn sich der Nutzer nicht in diesem Land befindet, sowie zum Anzeigen lokalisierter Inhalte, wenn Inhalte nicht in der Sprache des Nutzers verfügbar sind. |
hero |
Optionales Bannerbild, das auf der Vorderseite der Karte angezeigt wird. Andernfalls wird nichts angezeigt. Das Bild wird mit 100 % der Breite angezeigt. |
wordMark |
Verworfen. |
enable |
Gibt an, ob diese Klasse Smart Tap unterstützt. Die Felder |
hex |
Die Hintergrundfarbe der Karte. Wenn 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. |
localized |
Übersetzte Strings für den „issuerName“. Die empfohlene maximale Länge ist 20 Zeichen, damit der vollständige String auf kleineren Displays angezeigt wird. |
multiple |
Gibt an, ob mehrere Nutzer und Geräte dasselbe Objekt speichern, das auf diese Klasse verweist. |
callback |
Callback-Optionen, mit denen der Aussteller bei jedem Speichern/Löschen eines Objekts für diese Klasse durch den Endnutzer zurückgerufen wird. Alle Objekte dieser Klasse sind für den Callback berechtigt. |
security |
Optionale Informationen zur Sicherheitsanimation. Wenn diese Richtlinie konfiguriert ist, wird bei den Details der Karte / des Tickets eine Sicherheitsanimation gerendert. |
view |
Optionen für die Entsperrungsanforderungen der Geschenkkarte ansehen |
wide |
Das breite Logo des Geschenkkartenprogramms oder -unternehmens. Wenn Sie ein Bild angeben, wird es links oben in der Kartenansicht anstelle des Programmlogos verwendet. |
notify |
Gibt an, ob Feldaktualisierungen für diese Klasse 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 keine Angabe erfolgt, 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. |
app |
Optionaler Link zu einer App oder Website, der auf der Vorderseite der Karte/des Tickets als Schaltfläche angezeigt wird. Wenn für das entsprechende Objekt, das stattdessen verwendet wird, AppLinkData angegeben ist. |
value |
Optionale Daten zum Mehrwertmodul. Maximal zehn pro Kurs. Bei einer Karte/einem Ticket werden nur zehn angezeigt, wobei die Karten/Tickets des Objekts priorisiert werden. |
Methoden |
|
---|---|
|
Fügt der Geschenkkartenklasse, auf die durch die angegebene Klassen-ID verwiesen wird, eine Nachricht hinzu. |
|
Gibt die Geschenkkartenklasse mit der angegebenen Klassen-ID zurück. |
|
Fügt eine Geschenkkartenklasse mit der angegebenen ID und den angegebenen Eigenschaften ein. |
|
Gibt eine Liste aller Geschenkkartenklassen für eine bestimmte Aussteller-ID zurück. |
|
Aktualisiert die Geschenkkartenklasse, auf die durch die angegebene Klassen-ID verwiesen wird. |
|
Aktualisiert die Geschenkkartenklasse, auf die durch die angegebene Klassen-ID verwiesen wird. |