资源:FlightObject
JSON 表示法 |
---|
{ "kind": string, "classReference": { object ( |
字段 | |
---|---|
kind |
表明这是哪类资源。值:固定字符串 |
class |
父类的继承字段的副本。执行 GET 操作期间会检索这些字段。 |
passenger |
必需。显示在登机牌上的乘客姓名。 例如:“Dave M Gahan”“Gahan/Dave”或“GAHAN/DAVEM” |
boarding |
具体客户的登机和座位信息。 |
reservation |
必需。航班预订信息。 |
security |
适用于乘客的安全计划图片。 |
hex |
卡片的背景颜色。如果未设置,则使用主打图片的主体色;如果未设置主打图片,则使用徽标的主体色。格式为 #rrggbb,其中 rrggbb 为十六进制 RGB 三元组,例如 |
id |
必需。对象的唯一标识符。此 ID 在一个发卡机构的所有对象中必须是唯一的。此值应遵循“issuer ID”格式。identifier”格式,其中前者由 Google 提供,后者由您自行选择。该唯一标识符应仅包含字母数字字符、“.”“_”或“-”。 |
class |
必需。与此对象关联的类。该类必须与此对象具有相同的类型、已存在且已获批准。 类 ID 应遵循“issuer ID.identifier”格式,其中前者由 Google 提供,后者由您自行选择。 |
version |
已弃用 |
state |
必需。对象的状态。此字段用于确定对象在应用中的显示方式。例如,系统会将 |
barcode |
条形码的类型和值。 |
messages[] |
在应用中显示的一组消息。此对象的所有用户都将收到其关联消息。这些字段的数量上限为 10。 |
valid |
此对象处于 |
locations[] |
注意:此字段目前不支持触发地理位置通知。 |
has |
指明对象是否具有用户。此字段由平台设置。 |
smart |
系统将通过 NFC 将此对象的此值传输到经过智能感应认证的终端。您还必须正确设置类级字段 |
has |
指明此对象当前是否已关联到某个设备。当用户保存对象并将其关联到自己的设备时,平台会设置此字段。此字段仅供部分合作伙伴使用。如需了解详情,请与支持团队联系。 |
disable |
指明是否明确禁止通知。如果此字段设置为 true,则无论 此属性目前仅可用于设置航班。 |
info |
已弃用。请改用 textModulesData。 |
image |
图片模块数据。从对象级别开始,显示的字段数量上限为 1;对于类对象级别,则最多只能显示 1 个字段。 |
text |
文本模块数据。如果还在类中定义了文本模块数据,则将一并显示这些数据。从对象开始,显示的字段数量上限为 10;对于类,上限也为 10。 |
links |
链接模块数据。如果还在类中定义了链接模块数据,则将一并显示这些数据。 |
app |
可选的应用或网站链接,将以按钮的形式显示在卡券正面。如果为相应类提供了 AppLinkData,则系统只会显示对象 AppLinkData。 |
rotating |
旋转条形码的类型和值。 |
hero |
在卡片正面显示的可选横幅图片。如果没有,系统会显示课程的主打图片(如果有)。如果课程的主打图片也不存在,则不会显示任何内容。 |
grouping |
用于控制卡券分组方式的信息。 |
pass |
为对象传递约束条件。包括限制 NFC 和屏幕截图行为。 |
save |
对对象的限制,用户在尝试保存卡券之前需要先验证该对象。请注意,此限制仅在省电模式下应用。如果用户保存卡券后限制条件发生了变化,新限制条件不会应用于已保存的卡券。 |
linked |
linkObjectIds 是应自动附加到此航班对象的其他对象的列表,例如活动门票、会员卡、优惠、通用、礼品卡、公交卡和登机牌。如果用户已保存此登机牌,则系统会自动将这些 linkedObjectId 推送到用户的钱包(除非用户关闭了接收此类关联卡券的设置)。 确保已插入 linkedObjectIds 中存在的对象;如果没有,调用将会失败。关联后,关联的对象将无法解除关联。您无法关联属于其他发卡机构的对象。可与单个对象关联的对象数量存在限制。达到此上限后,系统会静默忽略调用中的新关联对象。 对象 ID 应遵循 issuer ID 格式。identifier”格式,其中前者由 Google 提供,后者由您自行选择。 |
notify |
是否应针对此对象触发字段更新通知。设置为 NOTIFY 时,我们会尝试向用户触发字段更新通知。只有当该字段已列入许可名单时,系统才会向用户发送此类通知。如果设置为 DO_NOT_NOTIFY 或 NOTIFICATION_SETTINGS_UNSPECIFIED,则不会触发任何通知。此设置是暂时性的,需要在每次 PATCH 或 UPDATE 请求中进行设置,否则系统不会触发通知。 |
value |
添加了可选值模块数据。对象上的最大值为 10。 |
BoardingAndSeatingInfo
JSON 表示法 |
---|
{ "kind": string, "boardingGroup": string, "seatNumber": string, "seatClass": string, "boardingPrivilegeImage": { object ( |
字段 | |
---|---|
kind |
表明这是哪类资源。值:固定字符串 |
boarding |
该乘客登机时所用的登机组(或登机区域)的值。 例如:“B” 此值的标签将由此对象引用的 |
seat |
乘客舱位的值。如果没有特定标识符,请改用 例如:“25A” |
seat |
舱位等级的值。 例如:“经济舱”或“舒适经济舱” |
boarding |
登机牌条形码上方显示的小图。航空公司可以用它来显示特殊的登机特权。如果还设置了安全计划徽标,则此图片可能会与安全计划徽标一起显示。 |
boarding |
登机位置的值。 例如:“76” |
sequence |
登机牌上的序号。它通常与乘客办理登机手续的顺序一致。航空公司可能会在人工登机手续和行李标签中使用该序号。 例如:“49” |
boarding |
仅当此航班有多个登机门或登机桥,并且您希望将登机门位置明确打印在登机牌上时,才设置此字段。大多数航空公司会按照 |
seat |
乘客的座位分配。在 例如:“在登机口分配” |
BoardingDoor
枚举 | |
---|---|
BOARDING_DOOR_UNSPECIFIED |
|
FRONT |
|
front |
|
BACK |
|
back |
|
ReservationInfo
JSON 表示法 |
---|
{
"kind": string,
"confirmationCode": string,
"eticketNumber": string,
"frequentFlyerInfo": {
object ( |
字段 | |
---|---|
kind |
标识所属资源种类。值:固定字符串 |
confirmation |
办理此航班登机手续所需的确认码。 乘客在机场自助服务终端查询航班并打印登机牌时需要输入此号码。 |
eticket |
电子机票号码。 |
frequent |
飞行常客会员信息。 |
FrequentFlyerInfo
JSON 表示法 |
---|
{
"kind": string,
"frequentFlyerProgramName": {
object ( |
字段 | |
---|---|
kind |
标识所属资源种类。值:固定字符串 |
frequent |
飞行常客奖励计划的名称。例如:“汉莎航空飞常里程汇” |
frequent |
飞行常客奖励计划编号。 对于每个类型为 |
方法 |
|
---|---|
|
向指定对象 ID 引用的航班对象添加消息。 |
|
返回具有指定对象 ID 的航班对象。 |
|
插入具有指定 ID 和属性的航班对象。 |
|
返回指定发卡机构 ID 对应的所有航班对象的列表。 |
|
更新指定对象 ID 引用的航班对象。 |
|
更新指定对象 ID 引用的航班对象。 |