背景
透過「自動連結的票證」功能,你可以將其他票證傳送至 Google 錢包中已有現有票證的使用者你也可以 當使用者儲存「主要票證」時,預先連結會傳送至主要票證 (主要) 通過。自動連結票證會與主要票證歸為一組 摘要文字,指出使用者已收到新票證 連結。下列票證類型都可做為主要或已連結的票證:
- 活動票券
- 登機證
- 大眾運輸票證
- 優惠
- 禮物卡
- 會員票證
- 一般票證
![]() |
![]() |
包含摘要說明已新增票證的主要票證 | 連結至主要票證的新票證 |
應用實例
將票證連結至現有票證時,可能會有不同的用途。以下是幾個例子:
- 將優惠連結至現有的會員卡。
- 將餐券連結至登機證或活動票券。
- 將停車證連結至活動票券。
使用自動連結的票證時的注意事項
- 主要物件和連結的物件必須使用同一個核發單位 ID。
- 每個主要物件最多只能連結 50 個連結物件。
- 無法保證會自動推送已連結的票證 盡可能提供最佳服務使用者可以選擇不接收自動連結的票證。如果用途 而且使用者必須收到已連結的票證,因此建議您 透過其他管道進行通訊,以確保使用者新增票證。
- Google 錢包 AUP 更新內容 包括使用自動連結票證的相關指引。
整合步驟
如果您已建立主要物件,可以略過步驟 1。
- 建立列出任何票證類型的物件 取代為必要參數此為主要物件。
- 為列出的任何票證類型建立另一個物件。這將是 linked物件。
- 在儲存主要物件之前或之後,update 與已連結物件 ID 中已連結物件 ID 的主要物件 參數。
必須在主要節點上設定 linkedObjectIds 的最低酬載 略過3 個必要參數包括:
- ISSUERID.PRIMARY_OBJECT_ID
- ISSUERID.PRIMARY_CLASS_ID
- 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 個) 略過 |