ภาพรวม

Google Wallet Passes API ทำให้พาร์ทเนอร์สามารถประหยัดเงิน กำลังหมุน บาร์โค้ดไปยัง Google Wallet บาร์โค้ดเหล่านี้จะใช้ได้เพียงระยะเวลาสั้นๆ ที่ให้ความปลอดภัยมากขึ้นเพื่อลดความเสี่ยงของภาพหน้าจอบาร์โค้ด จะสร้างขึ้นบนอุปกรณ์ตาม RFC 6238 โดยพาร์ทเนอร์จะระบุ คีย์ลับ อย่างไรก็ตาม หากพาร์ทเนอร์ต้องการสร้างบาร์โค้ดเอง Google จะให้ API ที่ผู้ใช้สามารถอัปโหลดบาร์โค้ดเป็นกลุ่มไปยัง Google ได้ บาร์โค้ดเหล่านี้จะ ส่งผ่านไปยังผู้ใช้ ซึ่งจะทำหน้าที่เหมือนการหมุนบาร์โค้ด แสดงเป็นระยะเวลาสั้นๆ เราเรียกโซลูชันนี้ว่า "สร้างโดยพาร์ทเนอร์" บาร์โค้ดแบบหมุนเวียน

Rotating Barcode API ที่พาร์ทเนอร์สร้าง

บาร์โค้ดแบบหมุนเวียนที่พาร์ทเนอร์สร้างขึ้นโดยใช้ RotatingBarcode เดียวกัน ออบเจ็กต์ ต้องระบุประเภทเท่านั้น แต่เราขอแนะนําให้สร้างเงื่อนไขเริ่มต้นขนาดเล็กด้วย ชุดบาร์โค้ด (ใช้เวลาประมาณ 10 นาที) แล้วส่ง initialRotatingBarcodeValues พาร์ทเนอร์มีหน้าที่รับผิดชอบในการตรวจสอบว่า มีบาร์โค้ดที่ถูกต้องพร้อมใช้งานสำหรับผู้ใช้เสมอ และ initialRotatingBarcodeValues ช่วยให้ การเรียกการอัปโหลดกลุ่มครั้งต่อๆ ไปจะเป็นแบบไม่พร้อมกัน

  rotatingBarcode {
    initialRotatingBarcodeValues: object (RotatingBarcodeValues),
    type: enum (BarcodeType),
  }
ช่อง คำอธิบาย
initialRotatingBarcodeValues

object (RotatingBarcodeValues)

ค่าที่จะเข้ารหัสในบาร์โค้ด ต้องระบุอย่างน้อย 1 ค่า ชื่อย่อเหล่านี้ บาร์โค้ดมีไว้เพื่อเชื่อมช่องว่างระหว่างตอนที่ผู้ใช้ได้รับบัตรครั้งแรก และ เมื่อมีการเรียกการอัปโหลดกลุ่มครั้งต่อๆ ไป
type

enum (BarcodeType)

ต้องระบุ ประเภทของบาร์โค้ดนี้

ค่าที่ยอมรับได้ มีดังนี้

  • QR_CODE
  • PDF_417
RotatingBarcodeValues
ช่อง คำอธิบาย
startDateTime

string

วันที่/เวลาที่บาร์โค้ดแรกมีผล บาร์โค้ดจะหมุนเวียนผ่าน ด้วย periodMillis

นี่คือวันที่/เวลาในรูปแบบ ISO 8601 แบบขยายพร้อมออฟเซ็ต
values[]

string

ค่าที่จะเข้ารหัสในบาร์โค้ด ต้องระบุอย่างน้อย 1 ค่า

ไม่มีจำนวนค่าสูงสุด แต่โปรดทราบว่าขนาดของส่วนเนื้อหาของคำขอ ต้องไม่เกิน 5 MB
periodMillis

number

ระยะเวลาที่ใช้ได้สำหรับบาร์โค้ดแต่ละรายการ

การอัปเดตค่าบาร์โค้ดเป็นกลุ่ม

หลังจากสร้างออบเจ็กต์ RotatingBarcode แล้ว เราขอแนะนำให้อัปโหลด บาร์โค้ดทุกวัน จนกว่าบัตรของผู้ใช้จะหมดอายุ ซึ่งทำได้ด้วย ปลายทาง API ของ REST ต่อไปนี้

เมธอด: transitobject.uploadrotatingbarcodevalues

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

คำขอ HTTP

POST https://walletobjects.googleapis.com/upload/walletobjects/v1/transitObject/{resourc eId}/uploadRotatingBarcodeValues

พารามิเตอร์เส้นทาง

พารามิเตอร์ คำอธิบาย
resourceId

string

ตัวระบุที่ไม่ซ้ำกันสำหรับออบเจ็กต์

เนื้อหาของคำขอ

เนื้อหาของคำขอ (ซึ่งต้องไม่เกิน 5 MB) มีอินสแตนซ์ RotatingBarcodeValues

เมธอด: transitobject.downloadrotatingbarcodevalues

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

คำขอ HTTP

GET https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/do wnloadRotatingBarcodeValues?alt=media

พารามิเตอร์เส้นทาง

พารามิเตอร์ คำอธิบาย
resourceId

string

ตัวระบุที่ไม่ซ้ำกันสำหรับออบเจ็กต์

กลไกสำรอง

โปรดทราบว่าหาก RotatingBarcode ที่ถูกต้องเป็นอย่างอื่นไม่มีบาร์โค้ดที่ถูกต้องที่จะแสดง ยังไม่มีการอัปโหลด หรือใช้บาร์โค้ดปัจจุบันทั้งหมด) จะแสดงต่อผู้ใช้