จัดกลุ่มตั๋วเข้างานหลายใบ

ใช้รหัสการจัดกลุ่ม

โดยค่าเริ่มต้น การเพิ่มบัตรหลายใบลงในลิงก์เพิ่มลงใน Google Wallet รายการเดียวจะไม่จัดกลุ่มบัตรเหล่านั้นในแอป Google Wallet ของผู้ใช้ อย่างไรก็ตาม คุณจัดกลุ่มบัตรไว้ด้วยกันได้โดยตรวจสอบว่าบัตรทั้งหมดมีรหัสการจัดกลุ่มเดียวกัน บัตรที่จัดกลุ่มจะปรากฏพร้อมกันในแอป Google Wallet เมื่อเลือกกลุ่มบัตรแล้ว บัตรแต่ละใบจะแสดงในภาพสไลด์

คุณจัดกลุ่มบัตรเข้าด้วยกันได้โดยทำดังนี้

  • ระหว่างการจัดสรรเริ่มต้น
  • ใช้เมธอด update หรือ patch

หากต้องการเพิ่มบัตรไปยังกลุ่ม คุณต้องตั้งค่าพร็อพเพอร์ตี้ groupingInfo.groupingId ของออบเจ็กต์บัตร ระบบจะจัดกลุ่มออบเจ็กต์บัตรทั้งหมดที่มีค่า groupingId เดียวกันเข้าด้วยกันโดยอัตโนมัติ แม้ว่าจะเพิ่มแยกกันก็ตาม

ตัวอย่างต่อไปนี้แสดงบัตรสะสมคะแนนและข้อเสนอที่จัดกลุ่มไว้ด้วยกันเพื่อดึงดูดให้ผู้ใช้ใช้ทั้ง 2 อย่างในการซื้อครั้งถัดไป 

loyaltyObject = {
  "classId": "ISSUER_ID.GIFT_CARD_CLASS_SUFFIX",
  "id": "ISSUER_ID.GIFT_CARD_OBJECT_SUFFIX",
  "state": "ACTIVE",
  "groupingInfo": {
    # Note the same groupingId value
    "groupingId": "combinedGiftCardAndOfferId",
    "sortIndex": 1
  },
  "barcode": {
    "type": "QR_CODE",
    "value": "QR code"
  },
  "accountId": "Account id",
  "accountName": "Account name",
  "loyaltyPoints": {
  "label": "Points",
    "balance": {
      "int": 800
    }
  }
}

offerObject = {
  "classId": "ISSUER_ID.OFFER_CLASS_SUFFIX",
  "id": "ISSUER_ID.OFFER_OBJECT_SUFFIX",
  "state": "ACTIVE",
  "groupingInfo": {
    # Note the same groupingId value
    "groupingId": "combinedGiftCardAndOfferId",
    "sortIndex": 2
  },
  "barcode": {
      "type": "QR_CODE",
      "value": "QR code",
  },
}

การจัดกลุ่มตั๋วเข้างานโดยอัตโนมัติ

บางครั้งตั๋วเข้างานจะใช้เป็นกลุ่มแทนที่จะใช้แยกกัน สถานการณ์ทั่วไปในกรณีนี้คือ การจัดกลุ่มตั๋วสำหรับสมาชิกในครอบครัวหลายคน

ตั๋วเข้างานมีตรรกะเพิ่มเติมที่เปิดใช้การจัดกลุ่มอัตโนมัติตามพร็อพเพอร์ตี้ต่อไปนี้

  • EventClass.eventId
  • EventClass.eventName
  • EventClass.dateTime.start
  • ส่วนรหัสผู้ออกบัตรของ EventObject.id

การจัดกลุ่มกับ EventClass.eventId

ระบบจะจัดกลุ่มออบเจ็กต์ตั๋วเข้างานโดยอัตโนมัติเมื่อมีค่าเหมือนกันสำหรับพร็อพเพอร์ตี้ต่อไปนี้

  • EventClass.eventId
  • ส่วนรหัสผู้ออกบัตรของ EventObject.id

เมื่อออบเจ็กต์ตั๋วเข้างานตรงตามเกณฑ์นี้ ระบบจะจัดกลุ่มออบเจ็กต์ดังกล่าวแม้ว่า EventClass.eventName และ EventClass.dateTime.start จะต่างกันก็ตาม

การจัดกลุ่มที่ไม่มี EventClass.eventId

หากไม่ได้ตั้งค่า EventClass.eventId ระบบจะจัดกลุ่มค่าโดยอัตโนมัติหากพร็อพเพอร์ตี้ต่อไปนี้เหมือนกัน

  • EventClass.eventName
  • EventClass.dateTime.start
  • ส่วนรหัสผู้ออกบัตรของ EventObject.id