自動連結的票證

背景

透過「自動連結的票證」功能，你可以將其他票證傳送至 Google 錢包中已有現有票證的使用者你也可以 當使用者儲存「主要票證」時，預先連結會傳送至主要票證 (主要) 通過。自動連結票證會與主要票證歸為一組 摘要文字，指出使用者已收到新票證 連結。下列票證類型都可做為主要或已連結的票證：

  • 活動票券
  • 登機證
  • 大眾運輸票證
  • 優惠
  • 禮物卡
  • 會員票證
  • 一般票證
，瞭解如何調查及移除這項存取權。
自動連結票證主要範例 自動連結票證的次要範例
包含摘要說明已新增票證的主要票證 連結至主要票證的新票證

應用實例

將票證連結至現有票證時，可能會有不同的用途。以下是幾個例子：

  • 將優惠連結至現有的會員卡。
  • 將餐券連結至登機證或活動票券。
  • 將停車證連結至活動票券。

使用自動連結的票證時的注意事項

  • 主要物件和連結的物件必須使用同一個核發單位 ID。
  • 每個主要物件最多只能連結 50 個連結物件。
  • 無法保證會自動推送已連結的票證 盡可能提供最佳服務使用者可以選擇不接收自動連結的票證。如果用途 而且使用者必須收到已連結的票證，因此建議您 透過其他管道進行通訊，以確保使用者新增票證。
  • Google 錢包 AUP 更新內容 包括使用自動連結票證的相關指引。

整合步驟

如果您已建立主要物件，可以略過步驟 1。

  1. 建立列出任何票證類型的物件 取代為必要參數此為主要物件。
  2. 為列出的任何票證類型建立另一個物件。這將是 linked物件。
  3. 在儲存主要物件之前或之後，update 與已連結物件 ID 中已連結物件 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 也可能引發潛在錯誤， 包含；

訊息 原因
主要物件和連結物件未共用相同的核發者 編號。 您無法將已連結的物件附加至其他核發者的物件。
主要物件和連結的物件參照同一個物件。 您無法附加與 linkObject 相同的物件。
連結的物件不存在。 連結的物件應已插入錢包 也能使用 Google Cloud CLI 或 Compute Engine API
已連結的物件已有其他連結的物件。無法新增巢狀結構 連結的物件 已連結的物件不得有其他連結的物件。
物件已連結至其他物件。無法新增巢狀連結 如需儲存大量結構化物件 建議使用 Cloud Bigtable 主要物件本身不能是連結的物件。
已超過上限，因此無法新增其他連結物件。 主要連結票證數量已達上限 (50 個) 略過