资源:EventTicketClass
| JSON 表示法 | 
|---|
{ "kind": string, "eventName": { object (  | 
              
| 字段 | |
|---|---|
kind | 
                
                   
 表明这是哪类资源。值:固定字符串   | 
              
eventName | 
                
                   
 必需。活动的名称,例如“广州恒大主场迎战上海申花”。  | 
              
eventId | 
                
                   
 事件的 ID。此 ID 在一个账号的所有活动中应该是唯一的。如果用户已为同一活动保存了多张门票,则可使用此 ID 将门票分为一组。它最多可包含 64 个字符。 如有提供,分组会更稳定。请小心意外冲突,以免将不应划为一组的门票分为一组。如果您对每个活动只使用一个类,则只需将此属性设置为  如果未提供,平台将尝试使用其他数据对门票进行分组(可能不稳定)。  | 
              
logo | 
                
                   
 门票的徽标图片。此图片显示在应用的卡片详细信息视图中。  | 
              
venue | 
                
                   
 活动场地详情。  | 
              
dateTime | 
                
                   
 活动的日期和时间信息。  | 
              
confirmationCodeLabel | 
                
                   
 用于卡片详细信息视图中的确认码值 ( 不能同时设置   | 
              
customConfirmationCodeLabel | 
                
                   
 用于卡片详细信息视图的确认码值 ( 不能同时设置   | 
              
seatLabel | 
                
                   
 用于卡片详细信息视图中的座位值 ( 不能同时设置   | 
              
customSeatLabel | 
                
                   
 用于卡片详细信息视图中的座位值 ( 不能同时设置   | 
              
rowLabel | 
                
                   
 用于卡片详细信息视图中的排值 ( 不能同时设置   | 
              
customRowLabel | 
                
                   
 用于卡片详细信息视图中的排值 ( 不能同时设置   | 
              
sectionLabel | 
                
                   
 用于卡片详细信息视图中的区值 ( 不能同时设置   | 
              
customSectionLabel | 
                
                   
 用于卡片详细信息视图中的区值 ( 不能同时设置   | 
              
gateLabel | 
                
                   
 用于卡片详细信息视图中的入口值 ( 不能同时设置   | 
              
customGateLabel | 
                
                   
 用于卡片详细信息视图中的入口值 ( 不能同时设置   | 
              
finePrint | 
                
                   
 门票的细则、条款或条件。  | 
              
classTemplateInfo | 
                
                   
 有关应如何显示类的模板信息。如果未设置,Google 将回退为显示默认字段集。  | 
              
id | 
                
                   
 必需。类的唯一标识符。此 ID 在一个发卡机构的所有类中必须是唯一的。此值应遵循 issuer ID 格式。identifier”格式,其中前者由 Google 提供,后者由您自行选择。您的唯一标识符应仅包含字母数字字符、“.”“_”或“-”。  | 
              
version | 
                
                   
 已弃用  | 
              
issuerName | 
                
                   
 必需。发卡机构名称。建议的最大长度为 20 个字符,以确保字符串能在较小的屏幕上完整显示。  | 
              
messages[] | 
                
                   
 在应用中显示的一组消息。此对象的所有用户都将收到其关联消息。这些字段的数量上限为 10。  | 
              
allowMultipleUsersPerObject | 
                
                   
 已弃用。请改用   | 
              
homepageUri | 
                
                   
 应用首页的 URI。在此字段中填充 URI 的效果与在 linksModuleData 中填充 URI 的效果完全相同(在呈现对象时,显示的首页链接通常被认为是该对象的 linksModuleData 部分)。  | 
              
locations[] | 
                
                   
 注意:此字段目前不支持触发地理位置通知。  | 
              
reviewStatus | 
                
                   
 必需。类的状态。此字段可通过插入、修补或更新 API 调用设置为  如果该类尚在开发中,您应将此字段保留为  如果您认为该类可以随时使用,您应将此字段设置为  更新已设为   | 
              
review | 
                
                   
 当某个类被标记为   | 
              
infoModuleData | 
                
                   
 已弃用。请改用 textModulesData。  | 
              
imageModulesData[] | 
                
                   
 图片模块数据。从对象级别开始,显示的字段数量上限为 1;对于类对象级别,上限也为 1。  | 
              
textModulesData[] | 
                
                   
 文本模块数据。如果还在类中定义了文本模块数据,则将一并显示这些数据。从对象开始,显示的字段数量上限为 10;对于类,上限也为 10。  | 
              
linksModuleData | 
                
                   
 链接模块数据。如果还在对象中定义了链接模块数据,则将一并显示这些数据。  | 
              
redemptionIssuers[] | 
                
                   
 用于标识哪些兑换发卡机构可以通过智能感应功能兑换卡券。兑换发卡机构通过其发卡机构 ID 进行标识。兑换发行商必须至少配置一个 Smart Tap 键。 此外,还必须正确设置   | 
              
countryCode | 
                
                   
 国家/地区代码,用于在用户不在该国家/地区时显示发卡国家/地区,以及在用户的语言区域未推出该内容时显示本地化的内容。  | 
              
heroImage | 
                
                   
 在卡片正面显示的可选横幅图片。如果不存在,则不会显示任何内容。图片将以 100% 宽度显示。  | 
              
wordMark | 
                
                   
 已弃用。  | 
              
enableSmartTap | 
                
                   
 确定此类是否支持智能感应。此外,还必须正确设置   | 
              
hexBackgroundColor | 
                
                   
 卡片的背景颜色。如果未设置,则使用主打图片的正文色;如果未设置主打图片,则使用徽标的正文色。格式为 #rrggbb,其中 rrggbb 为十六进制 RGB 三元组,例如   | 
              
localizedIssuerName | 
                
                   
 已翻译的 issuerName 字符串。建议的最大长度为 20 个字符,以确保字符串能在较小的屏幕上完整显示。  | 
              
multipleDevicesAndHoldersAllowedStatus | 
                
                   
 指明是否允许多个用户和设备保存引用该类的同一个对象。  | 
              
callbackOptions | 
                
                   
 回调选项,用于在最终用户每次保存/删除此类的对象时回调发卡机构。此类的所有对象都可进行回调。  | 
              
securityAnimation | 
                
                   
 有关安全动画的可选信息。如果设置此属性,系统会在卡券详情中呈现安全动画。  | 
              
viewUnlockRequirement | 
                
                   
 查看活动门票的“解锁要求”选项。  | 
              
wideLogo | 
                
                   
 门票的宽幅徽标。如果提供,此图片将取代卡片视图左上角的徽标。  | 
              
notifyPreference | 
                
                   
 是否应针对此类触发字段更新通知。设置为 NOTIFY 时,我们会尝试向用户触发字段更新通知。只有当该字段已列入许可名单时,系统才会向用户发送这些通知。如果未指定,则不会触发任何通知。此设置是暂时性的,需要在每次 PATCH 或 UPDATE 请求中进行设置,否则系统不会触发通知。  | 
              
appLinkData | 
                
                   
 可选的应用或网站链接,将以按钮的形式显示在卡券正面。如果为相应对象提供了 AppLinkData,则系统会改用该 AppLinkData。  | 
              
valueAddedModuleData[] | 
                
                   
 添加了可选值模块数据。每门课程最多 10 人。对于一次传递,系统只会显示 10 个错误,并优先显示来自对象的错误。  | 
              
merchantLocations[] | 
                
                   
 商家营业地点。一个课程最多只能有 10 名学生。超出 10 个的任何其他 MerchantLocation 都将被拒绝。当用户进入 Google 设置的点周围半径范围内时,这些位置会触发通知。此字段取代了已废弃的 LatLongPoints。  | 
              
EventVenue
| JSON 表示法 | 
|---|
{ "kind": string, "name": { object (  | 
                
| 字段 | |
|---|---|
kind | 
                  
                     
 表明这是哪类资源。值:固定字符串   | 
                
name | 
                  
                     
 场地的名称,如“AT&T Park”。 这是必填字段。  | 
                
address | 
                  
                     
 场地的地址,例如“24 Willie Mays Plaza\nSan Francisco, CA 94107”。各地址行之间用换行符 ( 这是必填字段。  | 
                
EventDateTime
| JSON 表示法 | 
|---|
{ "kind": string, "doorsOpen": string, "start": string, "end": string, "doorsOpenLabel": enum (  | 
                
| 字段 | |
|---|---|
kind | 
                  
                     
 表明这是哪类资源。值:固定字符串   | 
                
doorsOpen | 
                  
                     
 场地的开始入场日期/时间。 这是 ISO 8601 扩展格式的日期/时间,可带也可不带偏移量。时间最高可指定到纳秒级精度。偏移量可指定到秒级精度(虽然 ISO 8601 中未以秒为精度指定偏移量)。 例如: 
 
 
 不带偏移量的日期/时间部分被视为“当地日期/时间”。此时间应为场地的当地日期/时间。例如,如果在该场地开展活动的时间为 2018 年 6 月 5 日 20 时,则当地日期/时间部分应为  如果没有偏移量信息,可能会无法使用某些丰富的功能。  | 
                
start | 
                  
                     
 活动的开始日期/时间。如果活动持续数天,则应为第一天的开始日期/时间。 这是 ISO 8601 扩展格式的日期/时间,可带也可不带偏移量。时间最高可指定到纳秒级精度。偏移量可指定到秒级精度(虽然 ISO 8601 中未以秒为精度指定偏移量)。 例如: 
 
 
 不带偏移量的日期/时间部分被视为“当地日期/时间”。此时间应为场地的当地日期/时间。例如,如果在该场地开展活动的时间为 2018 年 6 月 5 日 20 时,则当地日期/时间部分应为  如果没有偏移量信息,可能会无法使用某些丰富的功能。  | 
                
end | 
                  
                     
 活动的结束日期/时间。如果活动持续数天,则应是活动最后一天的结束日期/时间。 这是 ISO 8601 扩展格式的日期/时间,可带也可不带偏移量。时间最高可指定到纳秒级精度。偏移量可指定到秒级精度(虽然 ISO 8601 中未以秒为精度指定偏移量)。 例如: 
 
 
 不带偏移量的日期/时间部分被视为“当地日期/时间”。此时间应为场地的当地日期/时间。例如,如果在该场地开展活动的时间为 2018 年 6 月 5 日 20 时,则当地日期/时间部分应为  如果没有偏移量信息,可能会无法使用某些丰富的功能。  | 
                
doorsOpenLabel | 
                  
                     
 用于卡片详细信息视图中的开始入场时间值 ( 不能同时设置   | 
                
customDoorsOpenLabel | 
                  
                     
 用于卡片详细信息视图的开始入场时间值 ( 不能同时设置   | 
                
DoorsOpenLabel
| 枚举 | |
|---|---|
DOORS_OPEN_LABEL_UNSPECIFIED | 
                  |
DOORS_OPEN | 
                  |
doorsOpen | 
                  
  | 
                
GATES_OPEN | 
                  |
gatesOpen | 
                  
  | 
                
ConfirmationCodeLabel
| 枚举 | |
|---|---|
CONFIRMATION_CODE_LABEL_UNSPECIFIED | 
                  |
CONFIRMATION_CODE | 
                  |
confirmationCode | 
                  
  | 
                
CONFIRMATION_NUMBER | 
                  |
confirmationNumber | 
                  
  | 
                
ORDER_NUMBER | 
                  |
orderNumber | 
                  
  | 
                
RESERVATION_NUMBER | 
                  |
reservationNumber | 
                  
  | 
                
SeatLabel
| 枚举 | |
|---|---|
SEAT_LABEL_UNSPECIFIED | 
                  |
SEAT | 
                  |
seat | 
                  
  | 
                
RowLabel
| 枚举 | |
|---|---|
ROW_LABEL_UNSPECIFIED | 
                  |
ROW | 
                  |
row | 
                  
  | 
                
SectionLabel
| 枚举 | |
|---|---|
SECTION_LABEL_UNSPECIFIED | 
                  |
SECTION | 
                  |
section | 
                  
  | 
                
THEATER | 
                  |
theater | 
                  
  | 
                
GateLabel
| 枚举 | |
|---|---|
GATE_LABEL_UNSPECIFIED | 
                  |
GATE | 
                  |
gate | 
                  
  | 
                
DOOR | 
                  |
door | 
                  
  | 
                
ENTRANCE | 
                  |
entrance | 
                  
  | 
                
方法 | 
            |
|---|---|
                
 | 
              向指定类 ID 引用的活动门票类添加消息。 | 
                
 | 
              返回具有指定类 ID 的活动门票类。 | 
                
 | 
              插入具有指定 ID 和属性的活动门票类。 | 
                
 | 
              返回指定发卡机构 ID 的所有活动门票类的列表。 | 
                
 | 
              更新指定类 ID 引用的活动门票类。 | 
                
 | 
              更新指定类 ID 引用的活动门票类。 |