ข้อมูลเบื้องต้น
ฟีเจอร์บัตรที่ลิงก์อัตโนมัติช่วยให้คุณส่งบัตรเพิ่มเติมไปยัง ผู้ใช้ที่มีบัตรใน Google Wallet อยู่แล้ว นอกจากนี้คุณยัง บัตรที่ลิงก์ล่วงหน้าไปยังบัตรหลักเมื่อผู้ใช้บันทึกบัตรหลัก (หลัก) ระบบจะจัดกลุ่มบัตรที่ลิงก์อัตโนมัติกับบัตรหลักที่มี เหนือบัตรหลักที่แจ้งให้ผู้ใช้ทราบว่าบัตรใหม่ได้ ลิงก์แล้ว ประเภทบัตรต่อไปนี้รองรับเป็นบัตรหลักหรือบัตรที่ลิงก์
- ตั๋วกิจกรรม
- บอร์ดดิ้งพาส
- บัตรโดยสาร
- ข้อเสนอ
- บัตรของขวัญ
- บัตรสะสมคะแนน
- บัตรทั่วไป
บัตรหลักที่มีข้อความไฮไลต์ที่ระบุว่ามีการเพิ่มบัตรใบใหม่ | บัตรใหม่ที่ลิงก์กับบัตรหลัก |
กรณีการใช้งาน
คุณอาจมีกรณีการใช้งานที่แตกต่างกันสำหรับการลิงก์บัตรกับบัตรที่มีอยู่ ใช้บ้าง ตัวอย่างเช่น
- ลิงก์ข้อเสนอกับบัตรสะสมคะแนนที่มีอยู่
- ลิงก์บัตรกำนัลอาหารกับบอร์ดดิ้งพาสหรือตั๋วเข้างาน
- ลิงก์บัตรจอดรถกับตั๋วเข้างาน
ข้อควรพิจารณาเมื่อใช้บัตรที่ลิงก์อัตโนมัติ
- ออบเจ็กต์หลักและออบเจ็กต์ที่ลิงก์ต้องใช้ผู้ออกใบรับรองเดียวกัน
- ออบเจ็กต์ที่ลิงก์จำกัดไว้ที่ 50 รายการต่อออบเจ็กต์หลัก
- เราไม่รับประกันและพิจารณาการพุชบัตรที่ลิงก์โดยอัตโนมัติ ที่ดีที่สุด ผู้ใช้เลือกไม่รับบัตรที่ลิงก์อัตโนมัติได้ หากกรณีการใช้งานคือ ที่สำคัญ และผู้ใช้ต้องได้รับบัตรที่ลิงก์ เราขอแนะนำให้ การสื่อสารผ่านช่องทางอื่นเพื่อให้แน่ใจว่าผู้ใช้จะเพิ่มบัตรได้
- อัปเดตเกี่ยวกับ Google Wallet AUP มีคําแนะนําเกี่ยวกับการใช้บัตรที่ลิงก์อัตโนมัติซึ่งต้องปฏิบัติตาม
ขั้นตอนการผสานรวม
หากสร้างออบเจ็กต์หลักไว้แล้ว ให้ข้ามขั้นตอนที่ 1
- สร้างออบเจ็กต์ของบัตรประเภทใดก็ได้ที่ระบุไว้ ด้วยพารามิเตอร์ที่จำเป็น นี่คือออบเจ็กต์หลัก
- สร้างออบเจ็กต์อื่นในประเภทบัตรใดก็ได้ที่แสดงอยู่ นี่จะเป็นวันที่ ลิงก์แล้ว
- ก่อนหรือหลังจากที่บันทึกออบเจ็กต์หลักแล้ว ให้อัปเดต ออบเจ็กต์หลักที่มีรหัสของออบเจ็กต์ที่ลิงก์ใน linkedObjectIds พารามิเตอร์
ต้องมีเพย์โหลดขั้นต่ำเพื่อตั้งค่า 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 ไม่ถูกต้อง ซึ่งสามารถ รวม
ข้อความ | เหตุผล |
---|---|
ออบเจ็กต์หลักและออบเจ็กต์ที่ลิงก์ไม่ได้ใช้ผู้ออกใบรับรองรายเดียวกัน ID | คุณจะแนบออบเจ็กต์ที่ลิงก์กับออบเจ็กต์ของผู้ออกบัตรรายอื่นไม่ได้ |
ออบเจ็กต์หลักและออบเจ็กต์ที่ลิงก์อ้างอิงจากออบเจ็กต์เดียวกัน | คุณไม่สามารถแนบออบเจ็กต์เดียวกับ linkedObject ได้ |
ไม่มีออบเจ็กต์ที่ลิงก์ | ออบเจ็กต์ที่ลิงก์ควรถูกแทรกลงใน Wallet อยู่แล้ว API |
ออบเจ็กต์ที่ลิงก์มีออบเจ็กต์ที่ลิงก์รายการอื่นอยู่แล้ว ไม่สามารถเพิ่มการวางซ้อน ออบเจ็กต์ที่ลิงก์ | ออบเจ็กต์ที่ลิงก์ต้องไม่มีออบเจ็กต์อื่นที่ลิงก์อยู่ |
ออบเจ็กต์ลิงก์กับออบเจ็กต์อื่นแล้ว ไม่สามารถเพิ่มลิงก์ที่ซ้อนกัน ออบเจ็กต์ | ออบเจ็กต์หลักไม่สามารถเป็นออบเจ็กต์ที่ลิงก์เพียงอย่างเดียวได้ |
ไม่สามารถเพิ่มออบเจ็กต์ที่ลิงก์ได้อีก เนื่องจากเกินขีดจำกัดแล้ว | บัตรหลักที่ลิงก์ถึงขีดจำกัดสูงสุด 50 ใบแล้ว |