REST Resource: flightclass

{
  "kind": string,
  "localScheduledDepartureDateTime": string,
  "localEstimatedOrActualDepartureDateTime": string,
  "localBoardingDateTime": string,
  "localScheduledArrivalDateTime": string,
  "localEstimatedOrActualArrivalDateTime": string,
  "flightHeader": {
    object (FlightHeader)
  },
  "origin": {
    object (AirportInfo)
  },
  "destination": {
    object (AirportInfo)
  },
  "flightStatus": enum (FlightStatus),
  "boardingAndSeatingPolicy": {
    object (BoardingAndSeatingPolicy)
  },
  "localGateClosingDateTime": string,
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "languageOverride": string,
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}

string

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

string

必需。飞机离开登机口（而不是跑道）的预定日期和时间

注意：此字段的值不应太接近起飞时间。如需更新起飞时间（延误等），请设置 localEstimatedOrActualDepartureDateTime。

这是 ISO 8601 扩展格式的日期/时间，不带偏移量。可以指定精确到毫秒的时间。

例如：2027-03-05T06:30:00

此时间应该是机场的当地日期/时间（而不是世界协调时间 (UTC)）。

如果提供了世界协调时间 (UTC) 偏移量，Google 将拒绝请求。时区将由 Google 根据起飞机场来计算。

string

飞机离开登机口的预计时间，或飞机离开登机口的实际时间。注意：此时间不是飞机离开跑道的时间。

如果至少满足下列其中一个条件，就应设置此字段：

• 此时间与预定时间不同。Google 将使用此时间来计算延误时间。
• 飞机已离开登机口。Google 将使用此时间来通知用户航班的实际起飞时间。

这是 ISO 8601 扩展格式的日期/时间，不带偏移量。可以指定精确到毫秒的时间。

例如：2027-03-05T06:30:00

此时间应该是机场的当地日期/时间（而不是世界协调时间 (UTC)）。

如果提供了世界协调时间 (UTC) 偏移量，Google 将拒绝请求。时区将由 Google 根据起飞机场来计算。

string

将会印在登机牌上的登机时间。

这是 ISO 8601 扩展格式的日期/时间，不带偏移量。可以指定精确到毫秒的时间。

例如：2027-03-05T06:30:00

此时间应该是机场的当地日期/时间（而不是世界协调时间 (UTC)）。

如果提供了世界协调时间 (UTC) 偏移量，Google 将拒绝请求。时区将由 Google 根据起飞机场来计算。

string

飞机到达目的地登机口（而非跑道）的预定时间。

注意：此字段的值不应太接近航班时间。如需更新起飞时间（延误等），请设置 localEstimatedOrActualArrivalDateTime。

这是 ISO 8601 扩展格式的日期/时间，不带偏移量。可以指定精确到毫秒的时间。

例如：2027-03-05T06:30:00

此时间应该是机场的当地日期/时间（而不是世界协调时间 (UTC)）。

如果提供了世界协调时间 (UTC) 偏移量，Google 将拒绝请求。时区将由 Google 根据到达机场来计算。

string

飞机到达目的地登机口（而非跑道）的预计时间，或飞机到达登机口的实际时间。

如果至少满足下列其中一个条件，就应设置此字段：

• 此时间与预定时间不同。Google 将使用此时间来计算延误时间。
• 飞机已抵达登机口。Google 将使用此时间来通知用户航班已抵达登机口。

这是 ISO 8601 扩展格式的日期/时间，不带偏移量。可以指定精确到毫秒的时间。

例如：2027-03-05T06:30:00

此时间应该是机场的当地日期/时间（而不是世界协调时间 (UTC)）。

如果提供了世界协调时间 (UTC) 偏移量，Google 将拒绝请求。时区将由 Google 根据到达机场来计算。

object (FlightHeader)

必需。关于航空公司和航班号的信息。

object (AirportInfo)

必需。出发地机场。

object (AirportInfo)

必需。目的地机场。

enum (FlightStatus)

此航班的状态。

如果未设置，Google 将根据 FlightStats 等其他来源的数据来计算状态。

注意：API 响应中不会返回 Google 计算的状态。

object (BoardingAndSeatingPolicy)

登机和就座政策。这些政策指示向用户显示哪些标签。

string

将会印在登机牌上的登机口关闭时间。如果您不想将此字段打印在登机牌上，请勿设置此字段。

这是 ISO 8601 扩展格式的日期/时间，不带偏移量。可以指定精确到毫秒的时间。

例如：2027-03-05T06:30:00

此时间应该是机场的当地日期/时间（而不是世界协调时间 (UTC)）。

如果提供了世界协调时间 (UTC) 偏移量，Google 将拒绝请求。时区将由 Google 根据起飞机场来计算。

object (ClassTemplateInfo)

有关应如何显示类的模板信息。如果未设置，Google 将回退到显示一组默认字段。

string

如果存在此字段，则提供到用户设备上的登机牌将始终使用此语言。表示 BCP 47 语言标记。示例值为“en-US”“en-GB”“de”或“de-AT”。

string

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

string (int64 format)

已弃用

string

必需。发卡机构名称。建议的最大长度为 20 个字符，以确保字符串能在较小的屏幕上完整显示。

object (Message)

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

boolean

已弃用。请改用 multipleDevicesAndHoldersAllowedStatus。

object (Uri)

应用首页的 URI。在此字段中填充 URI 的效果与在 linksModuleData 中填充 URI 的效果完全相同（在呈现对象时，显示的首页链接通常被认为是该对象的 linksModuleData 部分）。

object (LatLongPoint)

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

enum (ReviewStatus)

必需。类的状态。此字段可通过插入、修补或更新 API 调用设置为 draft 或 underReview。审核状态从 draft 更改为其他状态后，便无法再改回 draft。

如果该类尚在开发中，您应将此字段保留为 draft。draft 类不能用于创建任何对象。

如果您认为该类可供使用，则应将此字段设置为 underReview。平台会将此字段自动设置为 approved，它可以立即用于创建或迁移对象。

更新已设为 approved 的类时，您应将此字段始终设置为 underReview。

object (Review)

当某个类被标记为 approved 或 rejected 时，由平台设置的评论意见。

object (InfoModuleData)

已弃用。请改用 textModulesData。

object (ImageModuleData)

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

object (TextModuleData)

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

object (LinksModuleData)

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

string (int64 format)

用于标识哪些兑换发卡机构可以通过智能感应功能兑换卡券。兑换发卡机构通过发卡机构 ID 进行标识。兑换发行商必须至少配置一个 Smart Tap 键。

此外，还必须正确设置 enableSmartTap 和对象级 smartTapRedemptionLevel 字段，才能支持智能感应式付款。

string

国家/地区代码，用于在用户不在该国家/地区时显示发卡国家/地区，以及在用户的语言区域未推出该内容时显示本地化的内容。

object (Image)

在卡片正面显示的可选横幅图片。如果不存在，则不会显示任何内容。图片将以 100% 宽度显示。

object (Image)

已弃用。

boolean

标识此类是否支持智能触碰。此外，还必须正确设置 redemptionIssuers 和对象级 smartTapRedemptionLevel 字段，才能支持智能感应式付款。

string

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

object (LocalizedString)

已翻译的 issuerName 字符串。建议的最大长度为 20 个字符，以确保字符串能在较小的屏幕上完整显示。

enum (MultipleDevicesAndHoldersAllowedStatus)

指明是否允许多个用户和设备保存引用该类的同一对象。

object (CallbackOptions)

回调选项，用于在最终用户每次保存/删除此类的对象时回调发卡机构。此类的所有对象都有资格进行回调。

object (SecurityAnimation)

有关安全动画的可选信息。如果已设置此参数，系统将在卡券详情上呈现安全动画。

enum (ViewUnlockRequirement)

查看登机牌的“解锁要求”选项。

enum (NotificationSettingsForUpdates)

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

object (AppLinkData)

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

object (ValueAddedModuleData)

添加了可选值模块数据。课程最多可以有 10 个。对于卡券，仅显示 10 个卡券，优先显示来自相应对象的卡券。