REST Resource: flightobject

{
  "kind": string,
  "classReference": {
    object (FlightClass)
  },
  "passengerName": string,
  "boardingAndSeatingInfo": {
    object (BoardingAndSeatingInfo)
  },
  "reservationInfo": {
    object (ReservationInfo)
  },
  "securityProgramLogo": {
    object (Image)
  },
  "hexBackgroundColor": 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)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}

string

表明这是哪类资源。值：固定字符串 "walletobjects#flightObject"。

object (FlightClass)

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

string

必需。显示在登机牌上的乘客姓名。

例如：“Dave M Gahan”“Gahan/Dave”或“GAHAN/DAVEM”

object (BoardingAndSeatingInfo)

具体客户的登机和座位信息。

object (ReservationInfo)

必需。航班预订信息。

object (Image)

适用于乘客的安全计划图片。

string

卡片的背景颜色。如果未设置，则使用主打图片的主体色；如果未设置主打图片，则使用徽标的主体色。格式为 #rrggbb，其中 rrggbb 为十六进制 RGB 三元组，例如 #ffcc00。您也可以使用 RGB 三元组的简写版本（即 #rgb），例如 #fc0。

string

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

string

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

类 ID 应遵循“issuer ID.identifier”格式，其中前者由 Google 提供，后者由您自行选择。

string (int64 format)

已弃用

enum (State)

必需。对象的状态。此字段用于确定对象在应用中的显示方式。例如，系统会将 inactive 对象移至“过期卡券”部分：

object (Barcode)

条形码的类型和值。

object (Message)

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

object (TimeInterval)

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

object (LatLongPoint)

注意：此字段目前不支持触发地理位置通知。

boolean

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

string

系统将通过 NFC 将此对象的此值传输到经过智能感应认证的终端。此外，还必须正确设置类级字段 enableSmartTap 和 redemptionIssuers，卡券才支持智能触碰。仅支持 ASCII 字符。

boolean

指明此对象当前是否已关联到某个设备。当用户保存对象并将其关联到设备时，平台会设置此字段。此字段仅供部分合作伙伴使用。如需了解详情，请与支持团队联系。

boolean

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

目前只能为 Google 机票设置此字段。

object (InfoModuleData)

已弃用。请改用 textModulesData。

object (ImageModuleData)

图片模块数据。从对象级别开始，显示的字段数量上限为 1；对于类对象级别，则最多只能显示 1 个字段。

object (TextModuleData)

文本模块数据。如果还在类中定义了文本模块数据，则将一并显示这些数据。对于对象和类，这些字段最多可显示 10 个。

object (LinksModuleData)

链接模块数据。如果还在类中定义了链接模块数据，则将一并显示这些数据。

object (AppLinkData)

可选的应用或网站链接，将以按钮的形式显示在卡券正面。如果为相应类提供了 AppLinkData，则系统只会显示对象 AppLinkData。

object (RotatingBarcode)

轮播的条形码类型和值。

object (Image)

在卡片正面显示的可选横幅图片。如果没有，系统会显示课程的主打图片（如果有）。如果课程的主打图片也不存在，则不会显示任何内容。

object (GroupingInfo)

用于控制卡券如何分组的信息。

object (PassConstraints)

传递对象的约束条件。包括限制 NFC 和屏幕截图行为。

object (SaveRestrictions)

对对象的限制，用户在尝试保存卡券之前需要先验证该对象。请注意，此限制仅在省电模式下应用。如果用户保存卡券后限制条件发生了变化，新限制条件不会应用于已保存的卡券。

string

linkedObjectIds 是应自动附加到此航班对象的其他对象（例如活动门票、会员卡、优惠、通用卡、礼品卡、公交卡和登机牌）的列表。如果用户保存了此登机牌，则系统会自动将这些 linkedObjectId 推送到用户的钱包（除非用户关闭了接收此类关联卡券的设置）。

确保已插入 linkedObjectIds 中存在的对象；如果没有，调用将会失败。关联后，关联的对象将无法解除关联。您无法关联属于其他发卡机构的对象。可与单个对象关联的对象数量存在限制。达到此上限后，系统会静默忽略调用中的新关联对象。

对象 ID 应遵循“issuer ID.identifier”格式，其中前者由 Google 提供，后者由您自行选择。

enum (NotificationSettingsForUpdates)

是否应针对此对象触发字段更新通知。如果设置为 NOTIFY，我们将尝试触发向用户发送的字段更新通知。只有当该字段已列入许可名单时，系统才会向用户发送此类通知。如果设置为 DO_NOT_NOTIFY 或 NOTIFICATION_SETTINGS_UNSPECIFIED，则不会触发任何通知。此设置是暂时性的，需要在每次 PATCH 或 UPDATE 请求中进行设置，否则系统不会触发通知。

object (ValueAddedModuleData)

添加了可选值模块数据。对象最多 10 个。

{
  "kind": string,
  "boardingGroup": string,
  "seatNumber": string,
  "seatClass": string,
  "boardingPrivilegeImage": {
    object (Image)
  },
  "boardingPosition": string,
  "sequenceNumber": string,
  "boardingDoor": enum (BoardingDoor),
  "seatAssignment": {
    object (LocalizedString)
  }
}

string

表明这是哪类资源。值：固定字符串 "walletobjects#boardingAndSeatingInfo"。

string

该乘客登机时所用的登机组（或登机区域）的值。

例如：“B”

此值的标签将由此对象引用的 flightClass 中的 boardingPolicy 字段确定。

string

乘客舱位的值。如果没有特定标识符，请改用 seatAssignment。

例如：“25A”

string

舱位等级的值。

例如：“经济舱”或“经济舱”

object (Image)

登机牌条形码上方显示的小图。航空公司可以用它来显示特殊的登机特权。如果还设置了安全计划徽标，则此图片可能会与安全计划徽标一起显示。

string

登机位置的值。

例如：“76”

string

登机牌上的序号。它通常与乘客办理登机手续的顺序一致。航空公司可能会在人工登机手续和行李标签中使用该序号。

例如：“49”

enum (BoardingDoor)

仅当此航班有多个登机门或登机桥，并且您希望将登机门位置明确打印在登机牌上时，才设置此字段。大多数航空公司会按照 seatClass 指定登机门/登机桥，将乘客分流到相应的登机门或登机桥。在这些情况下，请勿设置 boardingDoor。

object (LocalizedString)

乘客的座位分配。在 seatNumber 中没有要使用的特定标识符时使用。

例如：“在登机口分配”

{
  "kind": string,
  "confirmationCode": string,
  "eticketNumber": string,
  "frequentFlyerInfo": {
    object (FrequentFlyerInfo)
  }
}

string

标识所属资源种类。值：固定字符串 "walletobjects#reservationInfo"。

string

办理此航班登机手续所需的确认码。

乘客在机场自助服务终端查询航班并打印登机牌时需要输入此号码。

string

电子机票号码。

object (FrequentFlyerInfo)

飞行常客会员信息。

{
  "kind": string,
  "frequentFlyerProgramName": {
    object (LocalizedString)
  },
  "frequentFlyerNumber": string
}

string

表明这是哪类资源。值：固定字符串 "walletobjects#frequentFlyerInfo"。

object (LocalizedString)

飞行常客奖励计划的名称。例如：“汉莎航空飞常里程汇”

string

飞行常客编号。

对于每个类型为 walletobjects#frequentFlyerInfo 的嵌套对象，此属性为必需属性。