Resource: OfferClass
JSON representation |
---|
{ "kind": string, "title": string, "redemptionChannel": enum ( |
Fields | |
---|---|
kind |
Identifies what kind of resource this is. Value: the fixed string |
title |
Required. The title of the offer, such as "20% off any t-shirt." Recommended maximum length is 60 characters to ensure full string is displayed on smaller screens. |
redemption |
Required. The redemption channels applicable to this offer. |
provider |
Required. The offer provider (either the aggregator name or merchant name). Recommended maximum length is 12 characters to ensure full string is displayed on smaller screens. |
title |
The title image of the offer. This image is displayed in both the details and list views of the app. |
details |
The details of the offer. |
fine |
The fine print or terms of the offer, such as "20% off any t-shirt at Adam's Apparel." |
help |
The help link for the offer, such as |
localized |
Translated strings for the title. Recommended maximum length is 60 characters to ensure full string is displayed on smaller screens. |
localized |
Translated strings for the provider. Recommended maximum length is 12 characters to ensure full string is displayed on smaller screens. |
localized |
Translated strings for the details. |
localized |
Translated strings for the finePrint. |
short |
A shortened version of the title of the offer, such as "20% off," shown to users as a quick reference to the offer contents. Recommended maximum length is 20 characters. |
localized |
Translated strings for the short title. Recommended maximum length is 20 characters. |
class |
Template information about how the class should be displayed. If unset, Google will fallback to a default set of fields to display. |
id |
Required. The unique identifier for a class. This ID must be unique across all classes from an issuer. This value should follow the format issuer ID.identifier where the former is issued by Google and latter is chosen by you. Your unique identifier should only include alphanumeric characters, '.', '_', or '-'. |
version |
Deprecated |
issuer |
Required. The issuer name. Recommended maximum length is 20 characters to ensure full string is displayed on smaller screens. |
messages[] |
An array of messages displayed in the app. All users of this object will receive its associated messages. The maximum number of these fields is 10. |
allowMultipleUsersPerObject |
Deprecated. Use |
homepage |
The URI of your application's home page. Populating the URI in this field results in the exact same behavior as populating an URI in linksModuleData (when an object is rendered, a link to the homepage is shown in what would usually be thought of as the linksModuleData section of the object). |
locations[] |
Note: This field is currently not supported to trigger geo notifications. |
review |
Required. The status of the class. This field can be set to You should keep this field to You should set this field to When updating an already |
review |
The review comments set by the platform when a class is marked |
infoModuleData |
Deprecated. Use textModulesData instead. |
image |
Image module data. The maximum number of these fields displayed is 1 from object level and 1 for class object level. |
text |
Text module data. If text module data is also defined on the class, both will be displayed. The maximum number of these fields displayed is 10 from the object and 10 from the class. |
links |
Links module data. If links module data is also defined on the object, both will be displayed. |
redemption |
Identifies which redemption issuers can redeem the pass over Smart Tap. Redemption issuers are identified by their issuer ID. Redemption issuers must have at least one Smart Tap key configured. The |
country |
Country code used to display the card's country (when the user is not in that country), as well as to display localized content when content is not available in the user's locale. |
hero |
Optional banner image displayed on the front of the card. If none is present, nothing will be displayed. The image will display at 100% width. |
wordMark |
Deprecated. |
enable |
Identifies whether this class supports Smart Tap. The |
hex |
The background color for the card. If not set the dominant color of the hero image is used, and if no hero image is set, the dominant color of the logo is used. The format is #rrggbb where rrggbb is a hex RGB triplet, such as |
localized |
Translated strings for the issuerName. Recommended maximum length is 20 characters to ensure full string is displayed on smaller screens. |
multiple |
Identifies whether multiple users and devices will save the same object referencing this class. |
callback |
Callback options to be used to call the issuer back for every save/delete of an object for this class by the end-user. All objects of this class are eligible for the callback. |
security |
Optional information about the security animation. If this is set a security animation will be rendered on pass details. |
view |
View Unlock Requirement options for the offer. |
wide |
The wide title image of the offer. When provided, this will be used in place of the title image in the top left of the card view. |
notify |
Whether or not field updates to this class should trigger notifications. When set to NOTIFY, we will attempt to trigger a field update notification to users. These notifications will only be sent to users if the field is part of an allowlist. If not specified, no notification will be triggered. This setting is ephemeral and needs to be set with each PATCH or UPDATE request, otherwise a notification will not be triggered. |
app |
Optional app or website link that will be displayed as a button on the front of the pass. If AppLinkData is provided for the corresponding object that will be used instead. |
value |
Optional value added module data. Maximum of ten on the class. For a pass only ten will be displayed, prioritizing those from the object. |
RedemptionChannel
Enums | |
---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
|
INSTORE |
|
instore |
Legacy alias for |
ONLINE |
|
online |
Legacy alias for |
BOTH |
|
both |
Legacy alias for |
TEMPORARY_PRICE_REDUCTION |
|
temporaryPriceReduction |
Legacy alias for |
Methods |
|
---|---|
|
Adds a message to the offer class referenced by the given class ID. |
|
Returns the offer class with the given class ID. |
|
Inserts an offer class with the given ID and properties. |
|
Returns a list of all offer classes for a given issuer ID. |
|
Updates the offer class referenced by the given class ID. |
|
Updates the offer class referenced by the given class ID. |