资源:FlightClass
| JSON 表示法 | 
|---|
{ "kind": string, "localScheduledDepartureDateTime": string, "localEstimatedOrActualDepartureDateTime": string, "localBoardingDateTime": string, "localScheduledArrivalDateTime": string, "localEstimatedOrActualArrivalDateTime": string, "flightHeader": { object (  | 
              
| 字段 | |
|---|---|
kind | 
                
                   
 表明这是哪类资源。值:固定字符串   | 
              
localScheduledDepartureDateTime | 
                
                   
 必需。飞机离开登机口(而不是跑道)的预定日期和时间 注意:此字段的值不应太接近起飞时间。如需更新起飞时间(延误等),请设置  这是 ISO 8601 扩展格式的日期/时间,不带偏移量。可以指定精确到毫秒的时间。 例如: 此时间应该是机场的当地日期/时间(不是世界协调时间 [UTC])。 如果提供了世界协调时间 (UTC) 偏移量,Google 将拒绝请求。时区将由 Google 根据起飞机场来计算。  | 
              
localEstimatedOrActualDepartureDateTime | 
                
                   
 飞机离开登机口的预计时间,或飞机离开登机口的实际时间。注意:此时间不是飞机离开跑道的时间。 如果至少满足下列一个条件,则您应该设置此字段: 
 这是 ISO 8601 扩展格式的日期/时间,不带偏移量。可以指定精确到毫秒的时间。 例如: 此时间应该是机场的当地日期/时间(不是世界协调时间 [UTC])。 如果提供了世界协调时间 (UTC) 偏移量,Google 将拒绝请求。时区将由 Google 根据起飞机场来计算。  | 
              
localBoardingDateTime | 
                
                   
 将会印在登机牌上的登机时间。 这是 ISO 8601 扩展格式的日期/时间,不带偏移量。可以指定精确到毫秒的时间。 例如: 此时间应该是机场的当地日期/时间(不是世界协调时间 [UTC])。 如果提供了世界协调时间 (UTC) 偏移量,Google 将拒绝请求。时区将由 Google 根据起飞机场来计算。  | 
              
localScheduledArrivalDateTime | 
                
                   
 飞机到达目的地登机口(而非跑道)的预定时间。 注意:此字段的值不应太接近航班时间。如需更新起飞时间(延误等),请设置  这是 ISO 8601 扩展格式的日期/时间,不带偏移量。可以指定精确到毫秒的时间。 例如: 此时间应该是机场的当地日期/时间(不是世界协调时间 [UTC])。 如果提供了世界协调时间 (UTC) 偏移量,Google 将拒绝请求。时区将由 Google 根据到达机场来计算。  | 
              
localEstimatedOrActualArrivalDateTime | 
                
                   
 飞机到达目的地登机口(而非跑道)的预计时间,或飞机到达登机口的实际时间。 如果至少满足下列一个条件,则您应该设置此字段: 
 这是 ISO 8601 扩展格式的日期/时间,不带偏移量。可以指定精确到毫秒的时间。 例如: 此时间应该是机场的当地日期/时间(不是世界协调时间 [UTC])。 如果提供了世界协调时间 (UTC) 偏移量,Google 将拒绝请求。时区将由 Google 根据到达机场来计算。  | 
              
flightHeader | 
                
                   
 必需。关于航空公司和航班号的信息。  | 
              
origin | 
                
                   
 必需。出发地机场。  | 
              
destination | 
                
                   
 必需。目的地机场。  | 
              
flightStatus | 
                
                   
 本次航班的状态。 如果未设置,Google 将根据 FlightStats 等其他来源的数据来计算状态。 注意:API 响应中不会返回 Google 计算的状态。  | 
              
boardingAndSeatingPolicy | 
                
                   
 登机和就座政策。这些政策指示向用户显示哪些标签。  | 
              
localGateClosingDateTime | 
                
                   
 将会印在登机牌上的登机口关闭时间。如果您不想将此时间印在登机牌上,请不要设置此字段。 这是 ISO 8601 扩展格式的日期/时间,不带偏移量。可以指定精确到毫秒的时间。 例如: 此时间应该是机场的当地日期/时间(不是世界协调时间 [UTC])。 如果提供了世界协调时间 (UTC) 偏移量,Google 将拒绝请求。时区将由 Google 根据起飞机场来计算。  | 
              
classTemplateInfo | 
                
                   
 有关应如何显示类的模板信息。如果未设置,Google 将回退为显示默认字段集。  | 
              
languageOverride | 
                
                   
 如果存在此字段,则提供到用户设备上的登机牌将始终使用此语言。表示 BCP 47 语言标记。示例值为“en-US”“en-GB”“de”或“de-AT”。  | 
              
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 | 
                
                   
 查看登机牌的“解锁要求”选项。  | 
              
notifyPreference | 
                
                   
 是否应针对此类触发字段更新通知。设置为 NOTIFY 时,我们会尝试向用户触发字段更新通知。只有当该字段已列入许可名单时,系统才会向用户发送这些通知。如果未指定,则不会触发任何通知。此设置是暂时性的,需要在每次 PATCH 或 UPDATE 请求中进行设置,否则系统不会触发通知。  | 
              
appLinkData | 
                
                   
 可选的应用或网站链接,将以按钮的形式显示在卡券正面。如果为相应对象提供了 AppLinkData,则系统会改用该 AppLinkData。  | 
              
valueAddedModuleData[] | 
                
                   
 添加了可选值模块数据。每门课程最多 10 人。对于一次传递,系统只会显示 10 个错误,并优先显示来自对象的错误。  | 
              
merchantLocations[] | 
                
                   
 商家营业地点。一个课程最多只能有 10 名学生。超出 10 个的任何其他 MerchantLocation 都将被验证程序拒绝。当用户进入 Google 设置的点周围半径范围内时,这些位置会触发通知。此字段取代了已废弃的 LatLongPoints。  | 
              
FlightHeader
| JSON 表示法 | 
|---|
{ "kind": string, "carrier": { object (  | 
                
| 字段 | |
|---|---|
kind | 
                  
                     
 表明这是哪类资源。值:固定字符串   | 
                
carrier | 
                  
                     
 关于航空公司的信息。这是   | 
                
flightNumber | 
                  
                     
 不含 IATA 航空公司代码的航班号。此字段应仅包含数字。这是  例如:“123”  | 
                
operatingCarrier | 
                  
                     
 关于承运航空公司的信息。  | 
                
operatingFlightNumber | 
                  
                     
 承运航空公司使用的不含 IATA 代码的航班号。此字段应仅包含数字。 例如:“234”  | 
                
flightNumberDisplayOverride | 
                  
                     
 要用于航班号的替换值。用于显示的默认值为 carrier + flightNumber。如果需要向乘客显示其他值,请使用此字段替换默认行为。 例如:“XX1234 / YY576”  | 
                
FlightCarrier
| JSON 表示法 | 
|---|
{ "kind": string, "carrierIataCode": string, "carrierIcaoCode": string, "airlineName": { object (  | 
                
| 字段 | |
|---|---|
kind | 
                  
                     
 表明这是哪类资源。值:固定字符串   | 
                
carrierIataCode | 
                  
                     
 销售航空公司(与承运航空公司相对)的 IATA 航空公司代码,使用两个字符来表示。对于  例如:瑞士航空的销售航空公司 IATA 代码为“LX”  | 
                
carrierIcaoCode | 
                  
                     
 销售航空公司(与承运航空公司相对)的 ICAO 航空公司代码,使用三个字符来表示。对于  例如:易捷航空的销售航空公司 ICAO 代码为“EZY”  | 
                
airlineName | 
                  
                     
 使用 carrierIataCode 来指定的航空公司本地化名称。如果未设置,则系统使用来自  例如:“LX”对应的本地化名称为“瑞士航空”  | 
                
airlineLogo | 
                  
                     
 使用 carrierIataCode 和 localizedAirlineName 来描述的航空公司徽标。此徽标将呈现在卡详细信息视图的顶部。  | 
                
airlineAllianceLogo | 
                  
                     
 航空联盟的徽标,显示在乘客登机时扫描的二维码下方。  | 
                
wideAirlineLogo | 
                  
                     
 航空公司的宽幅徽标。如果提供,此图片将取代卡片视图左上角的航空公司徽标。  | 
                
AirportInfo
| JSON 表示法 | 
|---|
{
  "kind": string,
  "airportIataCode": string,
  "terminal": string,
  "gate": string,
  "airportNameOverride": {
    object ( | 
                
| 字段 | |
|---|---|
kind | 
                  
                     
 表明这是哪类资源。值:固定字符串   | 
                
airportIataCode | 
                  
                     
 IATA 机场代码(3 个字符)。对于  例如:“SFO”  | 
                
terminal | 
                  
                     
 航站楼名称。例如:“INTL”或“I”  | 
                
gate | 
                  
                     
 登机口的名称。例如:“B59”或“59”  | 
                
airportNameOverride | 
                  
                     
 可选字段,用于替换由 IATA 定义的机场城市名称。默认情况下,Google 会采用提供的  如需了解官方 IATA 机场城市名称,请访问 IATA 机场城市名称网站。例如,对于机场 IATA 代码“LTN”,IATA 网站显示对应的机场城市是“伦敦”。 如果未填写此字段,Google 将会显示“伦敦”。 但是,在此字段中填入自定义名称(例如“伦敦卢顿”)将会替换“伦敦”。  | 
                
FlightStatus
| 枚举 | |
|---|---|
FLIGHT_STATUS_UNSPECIFIED | 
                  |
SCHEDULED | 
                  航班准时、提前或延误。 | 
scheduled | 
                  
  | 
                
ACTIVE | 
                  航班正在飞行(滑行、起飞、降落、升空)。 | 
active | 
                  
  | 
                
LANDED | 
                  航班已降落在原始目的地。 | 
landed | 
                  
  | 
                
CANCELLED | 
                  航班已取消。 | 
cancelled | 
                  
  | 
                
REDIRECTED | 
                  航班已升空,但要飞往与原始目的地不同的机场。 | 
redirected | 
                  
  | 
                
DIVERTED | 
                  航班已降落在与原始目的地不同的机场。 | 
diverted | 
                  
  | 
                
BoardingAndSeatingPolicy
| JSON 表示法 | 
|---|
{ "kind": string, "boardingPolicy": enum (  | 
                
| 字段 | |
|---|---|
kind | 
                  
                     
 表明这是哪类资源。值:固定字符串   | 
                
boardingPolicy | 
                  
                     
 表示航空公司的登机政策。如果未设置,Google 将默认采用   | 
                
seatClassPolicy | 
                  
                     
 就座政策,它规定我们如何显示舱位等级。如果未设置,Google 将默认采用   | 
                
BoardingPolicy
| 枚举 | |
|---|---|
BOARDING_POLICY_UNSPECIFIED | 
                  |
ZONE_BASED | 
                  |
zoneBased | 
                  
  | 
                
GROUP_BASED | 
                  |
groupBased | 
                  
  | 
                
BOARDING_POLICY_OTHER | 
                  |
boardingPolicyOther | 
                  
  | 
                
SeatClassPolicy
| 枚举 | |
|---|---|
SEAT_CLASS_POLICY_UNSPECIFIED | 
                  |
CABIN_BASED | 
                  |
cabinBased | 
                  
  | 
                
CLASS_BASED | 
                  |
classBased | 
                  
  | 
                
TIER_BASED | 
                  |
tierBased | 
                  
  | 
                
SEAT_CLASS_POLICY_OTHER | 
                  |
seatClassPolicyOther | 
                  
  | 
                
方法 | 
            |
|---|---|
                
 | 
              向指定类 ID 引用的航班类添加消息。 | 
                
 | 
              返回具有指定类 ID 的航班类。 | 
                
 | 
              插入具有指定 ID 和属性的航班类。 | 
                
 | 
              返回指定发卡机构 ID 的所有航班类的列表。 | 
                
 | 
              更新指定类 ID 引用的航班类。 | 
                
 | 
              更新指定类 ID 引用的航班类。 |