แนวคิดหลักและคำศัพท์

เอกสารนี้แสดงรายการคำศัพท์และแนวคิดทั่วไปที่คุณควรทราบเมื่อใช้ Google Wallet API

ส่งบอล

ข้าม

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

ในกรณีส่วนใหญ่ ระบบจะสร้างบัตรโดยใช้ทั้งคลาส Passes และออบเจ็กต์ Passes

ผู้ออกบัตร

ผู้ออกบัตรคือหน่วยงานที่สร้างบัตรและออกบัตรให้แก่ผู้ใช้เพื่อบันทึกไว้ใน Google Wallet ผู้ออกบัตรจะเป็นเจ้าของบัตรต่างๆ และสามารถสร้าง ออก และอัปเดตบัตรได้ ผู้ออกบัตรอาจเป็นนักพัฒนาซอฟต์แวร์ บริษัท และองค์กรต่างๆ รวมถึงผู้รวบรวมข้อมูลที่สร้างและออกบัตรในนามของผู้อื่น เช่น บริษัทที่เชี่ยวชาญด้านการจำหน่ายตั๋วเข้าร่วมกิจกรรมหรือคูปองสำหรับผู้ค้าปลีก

ดูข้อมูลเพิ่มเติม

คลาสของบัตร

คลาสบัตรเป็นเทมเพลตที่ใช้ร่วมกันซึ่งสร้างบัตรขึ้น คลาสของบัตรจะกำหนดที่พักบางอย่างที่จะรวมไว้ในบัตรทั้งหมดที่ใช้บัตรดังกล่าว ผู้ออกบัตรสามารถสร้างได้หลายคลาส โดยแต่ละคลาสมีชุดพร็อพเพอร์ตี้เฉพาะของตนเองที่จะกำหนดแอตทริบิวต์ต่างๆ เช่น รูปแบบและลักษณะที่ปรากฏ รวมถึงฟีเจอร์เพิ่มเติม เช่น การแตะอัจฉริยะ รวมถึงการลงทะเบียนและลงชื่อเข้าใช้

ในกรณีส่วนใหญ่ บัตรจะสร้างขึ้นโดยการระบุคลาส Passes เพื่อกำหนดเทมเพลตของบัตร และออบเจ็กต์ Passes จะกำหนดข้อมูลเฉพาะเจาะจงสำหรับบัตรแต่ละใบที่จะออก

ดูข้อมูลเพิ่มเติม

ออบเจ็กต์บัตร

ออบเจ็กต์บัตรกำหนดบัตรแต่ละใบที่ออกให้กับผู้ใช้เพื่อบันทึกลงใน Google Wallet ออบเจ็กต์ Passes มักมีข้อมูลเฉพาะของผู้ใช้ ตัวอย่างเช่น ขณะที่คลาสบัตรอาจกำหนดลักษณะของบัตรบัตรของขวัญสำหรับร้านค้าบางอย่าง ออบเจ็กต์บัตรจะแสดงรายละเอียดเฉพาะ เช่น ยอดคงเหลือหรือวันที่หมดอายุ

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

ดูข้อมูลเพิ่มเติม

บัตรส่วนตัว

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

ดูข้อมูลเพิ่มเติม

การแตะอัจฉริยะ

Smart Tap เป็นโปรโตคอล Near Field Communication ที่เป็นกรรมสิทธิ์ของ Google ซึ่งใช้สำหรับการถ่ายโอนข้อมูลระหว่างอุปกรณ์เคลื่อนที่กับเทอร์มินัล NFC เทคโนโลยีการแตะอัจฉริยะช่วยให้ผู้ใช้แลกสิทธิ์บัตรที่บันทึกไว้ใน Google Wallet ได้โดยถือโทรศัพท์ไว้ใกล้กับเครื่องชำระเงิน NFC ที่เข้ากันได้

หากต้องการใช้โปรโตคอลการแตะอัจฉริยะกับบัตร คุณต้องสร้างความสัมพันธ์กับผู้ให้บริการเทอร์มินัลที่รองรับการแตะอัจฉริยะ

ดูข้อมูลเพิ่มเติม

API และ SDK

API ของ Google Wallet

Google Wallet API เป็นบริการจาก Google ที่ช่วยให้คุณสร้างและออกบัตรเพื่อให้ผู้ใช้บันทึกไว้ใน Google Wallets คุณสามารถใช้ API ได้หลายวิธี รวมถึง Google Wallet REST API, Google Wallet Android SDK และคอนโซล Google Wallet

API ของ REST สำหรับ Google Wallet

Google Wallet REST API คืออินเทอร์เฟซสำหรับการสร้างและจัดการบัตรแบบเป็นโปรแกรมโดยการส่งคำขอ HTTP ไปยัง Google Wallet API

หากต้องการใช้ Google Wallet REST API คุณจะต้องมีบัญชี Google Cloud เพื่อสร้างบัญชีบริการด้วย ซึ่งจะใช้ในการตรวจสอบสิทธิ์คำขอที่ส่งไปยัง Google Wallet REST API

Google Wallet Android SDK

Google Wallet Android SDK มอบวิธีที่สะดวกสำหรับการทำงานกับ Google Wallet API ในแอป Android เช่น การสร้างและการออกบัตร

เพิ่มลงใน Google Wallet

ปุ่ม "เพิ่มลงใน Google Wallet"

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

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

เนื้อหาและหลักเกณฑ์ในการใช้ปุ่มจะอยู่ในหลักเกณฑ์การใช้แบรนด์ของ Google Wallet API

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

ลิงก์ "เพิ่มลงใน Google Wallet" สร้างขึ้นโดยแนบ JWT ที่ลงชื่อแล้วต่อท้าย URL https://pay.google.com/gp/v/save/

บัญชีผู้ออกบัตร

โหมดสาธิต

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

ขณะอยู่ใน "โหมดสาธิต" ชื่อของบัตรที่คุณออกจะขึ้นต้นด้วยคำว่า "[ทดสอบเท่านั้น]" โดยอัตโนมัติ เพื่อระบุว่าบัตรดังกล่าวมีไว้สำหรับการทดสอบเท่านั้น

บัญชีทดสอบ

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

ข้อมูลธุรกิจ

หากต้องการสร้างบัญชีผู้ออกบัตรสำหรับ Google Wallet API คุณต้องตั้งค่า Business Profile เมื่อลงทะเบียนใช้งานคอนโซล Google Pay และ Wallet Business Profile ให้ข้อมูลพื้นฐานเกี่ยวกับบริษัทหรือองค์กรของคุณแก่ Google และจำเป็นต้องได้รับอนุมัติให้มีสิทธิ์เผยแพร่

ดูข้อมูลเพิ่มเติม

สิทธิ์การเผยแพร่

คุณต้องได้รับอนุมัติให้เข้าถึงการเผยแพร่ก่อนจึงจะออกบัตรที่ผู้ใช้ทุกคนบันทึกลงใน Google Wallet ได้ คุณต้องสร้างคลาส Passes อย่างน้อย 1 คลาสและมี Business Profile ที่ครบถ้วนจึงจะได้รับอนุมัติให้เข้าถึงได้ ผู้ออกบัตรที่ต้องการออกบัตรโดยใช้ Google Wallet Android SDK ต้องส่งลายนิ้วมือ SHA-1 สำหรับแอปของตนด้วย

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

ดูข้อมูลเพิ่มเติม

การตรวจสอบสิทธิ์

JSON Web Token (JWT)

JSON Web Token เป็นมาตรฐานอุตสาหกรรมที่ใช้กันโดยทั่วไปสำหรับการโอนข้อมูลเป็นออบเจ็กต์ JSON อย่างปลอดภัย เมื่อใช้ Google Wallet API คุณจะเข้ารหัสรายละเอียดของออบเจ็กต์บัตรที่คุณต้องการใช้เพื่อสร้างอินสแตนซ์บัตรในรูปแบบ JWT (อ่านว่า "jot") จากนั้นส่ง JWT นั้นในคำขอไปยัง Google Wallet API

JWT จะได้รับการเก็บรักษาไว้อย่างปลอดภัยโดยการลงชื่อด้วยข้อมูลลับที่แชร์ก่อนที่จะส่งไปยัง Google Wallet API หากคุณใช้ Google Wallet REST API ข้อมูลลับในการลงชื่อคือคีย์บัญชีบริการ Google Cloud หากคุณใช้ Google Wallet Android SDK ข้อมูลลับในการรับรองคือลายนิ้วมือ SHA-1 สำหรับแอป Android

บัญชีบริการ

บัญชีบริการ Google Cloud เป็นบัญชีชนิดพิเศษที่แอปพลิเคชันหรือภาระงานในการประมวลผลมักจะใช้งาน ไม่ใช่บัญชีของบุคคล ในกรณีที่เป็น Google Wallet API คุณจะใช้บัญชีบริการเพื่อตรวจสอบสิทธิ์คำขอที่ส่งไปยัง Google Wallet REST API

ระบบจะสร้างบัญชีบริการในคอนโซล Google Cloud หากต้องการใช้บัญชีบริการ คุณจะต้องเปิดใช้ Google Wallet API ในคอนโซลระบบคลาวด์ด้วยเพื่ออนุญาตให้บัญชีบริการส่งคำขอไปยัง Google Wallet REST API

ดูข้อมูลเพิ่มเติม

คีย์บัญชีบริการ

คีย์บัญชีบริการคือข้อมูลเข้าสู่ระบบที่คุณจะใช้เพื่อตรวจสอบสิทธิ์การเรียกไปยัง Google Wallet REST API คีย์บัญชีบริการถือว่ามีความละเอียดอ่อนสูงและต้องเก็บไว้เป็นส่วนตัว เนื่องจากคีย์ดังกล่าวให้สิทธิ์เข้าถึงฟีเจอร์ผู้ออกบัตร Pass หลายอย่างในบัญชีของคุณโดยใช้ Google Wallet REST API ซึ่งรวมถึงการสร้างคลาสบัตรและออบเจ็กต์บัตร

ดูข้อมูลเพิ่มเติม

ลายนิ้วมือ SHA-1

ลายนิ้วมือ SHA-1 ของใบรับรอง App Signing ของ Android เป็นเอกสารรับรองที่คุณจะใช้เพื่อตรวจสอบสิทธิ์การเรียกไปยัง Google Wallet API เมื่อใช้ Google Wallet Android SDK ลายนิ้วมือ SHA-1 ของใบรับรองสร้างขึ้นโดยใช้ Gradle หรือเครื่องมือคีย์ หากต้องการใช้ลายนิ้วมือในการตรวจสอบสิทธิ์คำขอ คุณต้องลงทะเบียนลายนิ้วมือในคอนโซล Google Wallet

ดูข้อมูลเพิ่มเติม