/walletobjects/v1/giftCardObject

GET

giftcardobject

Returns a list of all gift card objects for a given issuer ID.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://walletobjects.googleapis.com//walletobjects/v1/giftCardObject'

Response Example

Request

Query Params

classId

string

optional

The ID of the class whose objects will be listed.

maxResults

integer

optional

Identifies the max number of results returned by a list. All results are returned if maxResults isn't defined.

token

string

optional

Used to get the next set of results if maxResults is specified, but more than maxResults objects are available in a list. For example, if you have a list of 200 objects and you call list with maxResults set to 20, list will return the first 20 objects and a token. Call list again with maxResults set to 20 and the token to get the next 20 objects.

Responses

🟢200Successful response

application/json

Body

pagination

object (Pagination)

optional

Pagination of the response.

kind

string

optional

Identifies what kind of resource this is. Value: the fixed string "walletobjects#pagination".

nextPageToken

string

optional

Page token to send to fetch the next page.

resultsPerPage

integer <int32>

optional

Number of results returned in this page.

resources

array[object (GiftCardObject) {25}]

optional

Resources corresponding to the list request.

appLinkData

object (AppLinkData)

optional

Optional information about the partner app link.

balance

object (Money)

optional

The card's monetary balance.

balanceUpdateTime

object (DateTime)

optional

The date and time when the balance was last updated. Offset is required. If balance is updated and this property is not provided, system will default to the current time.

barcode

object (Barcode)

optional

The barcode type and value.

cardNumber

string

optional

Required. The card's number.

classId

string

optional

Required. The class associated with this object. The class must be of the same type as this object, must already exist, and must be approved. Class IDs should follow the format issuer ID.identifier where the former is issued by Google and latter is chosen by you.

classReference

object (GiftCardClass)

optional

A copy of the inherited fields of the parent class. These fields are retrieved during a GET.

disableExpirationNotification

boolean

optional

Indicates if notifications should explicitly be suppressed. If this field is set to true, regardless of the messages field, expiration notifications to the user will be suppressed. By default, this field is set to false. Currently, this can only be set for offers.

eventNumber

string

optional

The card's event number, an optional field used by some gift cards.

hasLinkedDevice

boolean

optional

Whether this object is currently linked to a single device. This field is set by the platform when a user saves the object, linking it to their device. Intended for use by select partners. Contact support for additional information.

hasUsers

boolean

optional

Indicates if the object has users. This field is set by the platform.

heroImage

object (Image)

optional

Optional banner image displayed on the front of the card. If none is present, hero image of the class, if present, will be displayed. If hero image of the class is also not present, nothing will be displayed.

string

optional

Required. The unique identifier for an object. This ID must be unique across all objects 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. The unique identifier should only include alphanumeric characters, '.', '_', or '-'.

imageModulesData

array[object (ImageModuleData) {2}]

optional

Image module data. The maximum number of these fields displayed is 1 from object level and 1 for class object level.

infoModuleData

object (InfoModuleData)

optional

Deprecated. Use textModulesData instead.

kind

string

optional

Identifies what kind of resource this is. Value: the fixed string "walletobjects#giftCardObject".

linksModuleData

object (LinksModuleData)

optional

Links module data. If links module data is also defined on the class, both will be displayed.

locations

array[object (LatLongPoint) {3}]

optional

The list of locations where the object can be used. The platform uses this information to trigger geolocated notifications to users. Note that locations in the object override locations in the class which override locations in the Google Places ID.

messages

array[object (Message) {8}]

optional

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.

string

optional

The card's PIN.

smartTapRedemptionValue

string

optional

Available only to Smart Tap enabled partners. Contact support for additional guidance.

state

enum<string>

optional

Required. The state of the object. This field is used to determine how an object is displayed in the app. For example, an inactive object is moved to the "Expired passes" section.

Allowed values:

STATE_UNSPECIFIEDACTIVEactiveCOMPLETEDcompletedEXPIREDexpiredINACTIVEinactive

textModulesData

array[object (TextModuleData) {5}]

optional

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.

validTimeInterval

object (TimeInterval)

optional

The time period this object will be active and object can be used. An object's state will be changed to expired when this time period has passed.

version

string <int64>

optional

Deprecated

Modified at 2022-09-10 16:56:46

/walletobjects/v1/giftCardClass/{resourceId}/addMessage

/walletobjects/v1/giftCardObject