จัดกลุ่มบอร์ดดิ้งพาสหลายใบ

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

โดยค่าเริ่มต้น การเพิ่มบัตรหลายใบลงในลิงก์เพิ่มลงใน 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",
  },
}

การจัดกลุ่มอัตโนมัติสำหรับบอร์ดดิ้งพาส

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

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

  • FlightClass.flightHeader.carrier.carrierIataCode
  • FlightClass.flightHeader.flightNumber
  • FlightClass.localScheduledDepartureDateTime
  • FlightObject.reservationInfo.confirmationCode
  • ส่วนรหัสผู้ออกบัตรของ FlightObject.id

หากพร็อพเพอร์ตี้ใดข้างต้นแตกต่างกันสำหรับบอร์ดดิ้งพาส 2 ใบ ระบบจะไม่จัดกลุ่มคุณสมบัติเหล่านั้น (เว้นแต่คุณจะใช้ groupingInfo) จะเห็นได้ว่าทั้งพร็อพเพอร์ตี้คลาสและออบเจ็กต์มีผลต่อการจัดกลุ่มอัตโนมัติ วิธีนี้ช่วยให้ระบบรวมบอร์ดดิ้งพาสของชั้นต่างๆ ไว้ด้วยกัน (เช่น เมื่อเที่ยวบินต่างๆ ในการเดินทางเดียวกันมีผู้ให้บริการขนส่งที่แตกต่างกัน)