自動新增登機證

背景

這項功能可讓航空公司自動將登機證推送到使用者的 Google 錢包。對於經常搭機的旅客來說，這項功能特別實用，因為他們搭機頻率較高，可以更輕鬆地將登機證新增至錢包，減少操作上的麻煩。

無論透過哪個管道辦理入住手續 (例如網站、應用程式或機場自助服務機)，系統都會自動執行這項作業。航空公司合作夥伴可以根據使用者的會員帳戶號碼，將票證推送至 Google 錢包。

Flow

這項功能的運作方式

步驟 1：啟用功能，允許常旅客將常旅客會員憑證新增至 Google 錢包。

步驟 2：將常旅客的新登機證連結至錢包中的會員卡，即可自動新增。

最佳做法

  • 如要讓常旅客順利註冊會員，請考慮啟用「使用 Google 帳戶註冊 / 登入」流程。使用者之後就能在 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 使用方式有誤，可能會發生下列錯誤：

訊息 原因
主要物件和連結物件未共用相同的發行者 ID。 你無法將已連結的物件附加至其他發卡機構的物件。
主要物件和連結物件參照同一個物件。 您無法附加與 linkedObject 相同的物件。
連結的物件不存在。 連結的物件應已插入 Google 錢包 API。
連結的物件已連結至其他物件。無法新增巢狀連結物件。 連結的物件無法再連結其他物件。
物件已連結至另一個物件。無法新增巢狀連結物件。 主要物件本身不得為連結物件。