自动添加登机牌

背景

借助此功能，航空公司可以自动将登机牌推送到用户的 Google 钱包中。这对于经常乘坐飞机的旅客来说尤其有用，因为他们出行频率较高，因此能够以更简单、更顺畅的方式将登机牌添加到 Google 钱包中。

无论通过何种渠道办理值机手续（例如网站、应用或机场自助服务终端），系统都会自动执行此操作。航空公司合作伙伴可以使用用户的会员卡账号来关联和推送卡券到用户的钱包。

此功能的运作方式

第 1 步：允许飞行常客将其飞行常客奖励计划会员卡添加到 Google 钱包。

第 2 步：通过将新登机牌与飞行常客奖励计划会员卡关联，自动添加新登机牌。

最佳做法

• 为了让常旅客能够顺畅地加入会员计划，请考虑启用使用 Google 账号注册 / 登录流程。然后，用户将能够在 Google 钱包中的各种入口点（包括登机牌）发现您航空公司的会员注册流程。
• 考虑在 Android 应用和网站上为现有会员回馈活动会员启用一键加入功能。

注意：此功能是自动关联卡券功能的一种特定实现。在此背景下，主卡是指会员卡，关联卡是指登机牌。本文档的其余部分将使用更广泛的术语（自动关联的卡券、主卡券和关联的卡券）来描述此功能。

使用自动关联的卡券时的一些注意事项

• 主对象和关联对象必须使用相同的 issuerId。
• 我们无法保证自动推送关联的卡券，这属于尽力而为的范畴。用户可以选择不接收自动关联的卡券。如果使用情形非常重要，用户必须收到关联的卡券，我们建议通过其他渠道进行沟通，以确保用户添加卡券。
• Google 钱包 AUP 的更新内容包括有关使用自动关联卡券的指南，您必须遵守这些指南。

集成步骤

如果您已创建主要对象，则可以跳过第 1 步。

1. 使用必需的参数创建任意列出的卡券类型的对象。这是主要对象。
2. 创建所列任何类型的其他卡券对象。这将是关联的对象。
3. 在保存主对象之前或之后，使用 linkedObjectIds 参数中的关联对象 ID 更新主对象。

设置主卡上的 linkedObjectIds 需要最低载荷。3 个必需参数包括：

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

用于向卡券对象添加关联对象的 JSON 请求示例

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

将对象与卡券对象相关联后的 JSON 响应示例

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

异常处理

如果 API 使用不当，可能会出现以下潜在错误：