REST 资源:eventticketobject

资源:EventTicketObject

JSON 表示法

{
  "kind": string,
  "classReference": {
    object (EventTicketClass)
  },
  "seatInfo": {
    object (EventSeat)
  },
  "reservationInfo": {
    object (EventReservationInfo)
  },
  "ticketHolderName": string,
  "ticketNumber": string,
  "ticketType": {
    object (LocalizedString)
  },
  "faceValue": {
    object (Money)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "linkedOfferIds": [
    string
  ],
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  }
}
字段
kind
(deprecated)

string

指明资源的种类。值:固定字符串 "walletobjects#eventTicketObject"

classReference

object (EventTicketClass)

父类的继承字段的副本。执行 GET 操作期间会检索这些字段。

seatInfo

object (EventSeat)

此门票的座位详细信息。

reservationInfo

object (EventReservationInfo)

此门票的预订详细信息。在同一订单中购买的所有门票都会具有此信息。

ticketHolderName

string

门票持有者的姓名(如果门票已分配给某人)。例如“John Doe”或“Jane Doe”。

ticketNumber

string

门票的号码。它可以是以下各门票的一个唯一标识符:发行者系统中的所有门票、活动的所有门票(例如 XYZ1234512345)或订单中的所有门票(1、2、3 等)。

ticketType

object (LocalizedString)

门票的类型,例如“成人”、“儿童”、“VIP”或“标准”。

faceValue

object (Money)

门票的面值,与印在实物门票上的面额一致。

groupingInfo

object (GroupingInfo)

活动门票的分组信息。

linkedOfferIds[]

string

与此活动门票关联的优惠对象的列表。优惠对象必须已经存在。

优惠对象 ID 应遵循“<发卡机构 ID>.<标识符>”格式,其中发卡机构 ID 由 Google 提供,标识符由您自行选择。

id

string

对象的唯一标识符。此 ID 在一个发卡机构的所有对象中必须是唯一的。此值应遵循“<发卡机构 ID>.<标识符>”格式,其中发卡机构 ID 由 Google 提供,标识符由您自行选择。该唯一标识符应仅包含字母数字字符、“.”、“_”或“-”。

classId

string

与此对象关联的类。该类必须与此对象具有相同的类型、已存在且已获批准。

类 ID 应遵循“<发卡机构 ID>.<标识符>”格式,其中发卡机构 ID 由 Google 提供,标识符由您自行选择。

version
(deprecated)

string (int64 format)

现已弃用

state

enum (State)

对象的状态。此字段用于确定对象在应用中的显示方式。例如,inactive 对象不会再在 Google Pay 应用中显示。

barcode

object (Barcode)

条形码的类型和值。

messages[]

object (Message)

在应用中显示的一组消息。此对象的所有用户都将收到其关联消息。这些字段的数量上限为 10。

validTimeInterval

object (TimeInterval)

此对象处于 active 状态且可供使用的时间段。这段时间过后,对象的状态将更改为 expired

locations[]

object (LatLongPoint)

可使用对象的位置的列表。平台使用此信息来触发发送给用户的地理定位通知。请注意,对象中的位置会替换类中的位置,而类中的位置又会替换 Google 商家信息 ID 中的位置。

hasUsers

boolean

指明对象是否具有用户。此字段由平台设置。

smartTapRedemptionValue

string

仅适用于支持智能触碰技术的合作伙伴。如需更多指导,请与支持人员联系。

hasLinkedDevice

boolean

指明此对象当前是否已关联到某个设备。当用户保存对象并将其关联到自己的设备时,平台会设置此字段。此字段仅供部分合作伙伴使用。如需获取更多信息,请与支持人员联系。

disableExpirationNotification

boolean

指明是否明确禁止通知。如果此字段设置为 true,则无论 messages 字段如何设置,都会禁止向用户发出失效通知。此字段默认设置为 false。

此属性目前仅可用于设置优惠对象。

infoModuleData

object (InfoModuleData)

现已弃用。请改用 textModulesData。

imageModulesData[]

object (ImageModuleData)

图片模块数据。如果还在类中定义了图片模块数据,则这些数据将与对象中定义的图片数据进行合并。这些字段(与类组合使用)的数量上限为 1。

textModulesData[]

object (TextModuleData)

文本模块数据。如果还在类中定义了文本模块数据,则将一并显示这些数据。这些字段(与类组合使用)的数量上限为 10。

EventSeat

JSON 表示法

{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
字段
kind
(deprecated)

string

指明资源的种类。值:固定字符串 "walletobjects#eventSeat"

seat

object (LocalizedString)

座位号,例如“1”、“2”、“3”或任何其他座位标识符。

此字段可本地化,因此您可以翻译字词或使用其他字母作为标识符中的字符。

row

object (LocalizedString)

座位所在的排,例如“1”、“E”、“BB”或“A5”。

此字段可本地化,因此您可以翻译字词或使用其他字母作为标识符中的字符。

section

object (LocalizedString)

座位所在的区,例如“121”。

此字段可本地化,因此您可以翻译字词或使用其他字母作为标识符中的字符。

gate

object (LocalizedString)

门票持有者到达其座位所经的入口,例如“A”入口或“西”入口。

此字段可本地化,因此您可以翻译字词或使用其他字母作为标识符中的字符。

EventReservationInfo

JSON 表示法

{
  "kind": string,
  "confirmationCode": string
}
字段
kind
(deprecated)

string

指明资源的种类。值:固定字符串 "walletobjects#eventReservationInfo"

confirmationCode

string

活动预订的确认码。也可能以“订单号”、“确认号”、“预订号”或其他等效形式出现。

GroupingInfo

NEXT_ID: 2

JSON 表示法

{
  "sortIndex": number
}
字段
sortIndex

number

与其他卡券一起分组时,用于对卡券进行排序的可选索引。排序索引低的卡券显示在排序索引高的卡券前面。如果未指定,系统会假定该值为 INT_MAX。如果两张卡券的排序索引相同,表明未定义排序行为。

方法

addmessage

向指定对象 ID 引用的活动门票对象添加消息。

get

返回具有指定对象 ID 的活动门票对象。

insert

插入具有指定 ID 和属性的活动门票对象。

list

返回指定类 ID 的所有活动门票对象的列表。

modifylinkedofferobjects

修改具有指定 ID 的活动门票对象的关联优惠对象。

patch

更新指定对象 ID 引用的活动门票对象。

update

更新指定对象 ID 引用的活动门票对象。