ฟีเจอร์การลงทะเบียนบัตรของขวัญ (การลงชื่อเข้าใช้) ช่วยให้ผู้ใช้ค้นหาบัตรของขวัญและเพิ่มลงใน Google Wallet ได้ ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังเว็บไซต์ที่รองรับอุปกรณ์เคลื่อนที่เพื่อดำเนินการให้เสร็จสมบูรณ์ จากนั้นผู้ใช้จะเพิ่มบัตรลงใน Google Wallet ได้
คู่มือนี้จะกล่าวถึงภาพรวมของขั้นตอนการติดตั้งใช้งานที่จำเป็นเพื่อเปิดใช้โปรแกรมบัตรของขวัญสำหรับฟีเจอร์นี้
ภาพรวม
ในการเริ่มต้นใช้งาน ให้ตรวจสอบว่าคุณได้ตั้งค่าโปรเจ็กต์ไว้ก่อนหน้านี้และมีสิทธิ์เข้าถึง Google Wallet API
คุณต้องทําตาม 4 ขั้นตอนต่อไปนี้เพื่อใช้ฟีเจอร์ลงชื่อเข้าใช้สําหรับโปรแกรมบัตรของขวัญ
- ตั้งค่าคลาสทดสอบใน Google Wallet เพื่อทดสอบขั้นตอนการลงชื่อเข้าใช้
- พัฒนาหน้าลงชื่อเข้าใช้ที่ใช้ Google Wallet
SharedDataType - ใช้การส่งบัตรของขวัญไปยัง Google Wallet หลังจากลงชื่อเข้าใช้
- ขอการยืนยันและการเปิดใช้งาน
ตั้งค่าชั้นเรียนทดสอบใน Google Wallet
กำหนด URL การลงชื่อเข้าใช้และโลโก้โปรแกรม จากนั้นใช้discoverableProgramช่องที่ฝังใน giftcardclass เพื่อกำหนดค่าที่เหมาะสม
ตั้งค่าใน discoverableProgram เพื่อสร้างโปรแกรมบัตรของขวัญที่เปิดใช้การลงชื่อเข้าใช้เวอร์ชันฉบับร่าง โปรดตรวจสอบว่าผู้ทดสอบมีสิทธิ์เข้าถึง Google Pay และ Wallet Console เพื่อให้ผู้ทดสอบเห็นข้อมูลนี้ ดูรายละเอียดเกี่ยวกับวิธีแชร์สิทธิ์เข้าถึง Google Pay และ Wallet Console กับผู้อื่นได้ที่ดูข้อมูลเกี่ยวกับหน้าผู้ใช้
หากต้องการยืนยันฟังก์ชันการทำงานของการติดตั้งใช้งานให้เสร็จสมบูรณ์ในระหว่างกระบวนการพัฒนา โปรดติดต่อเราโดยใช้วิดเจ็ตติดต่อทีมสนับสนุนใน Google Pay และ Wallet Console ขณะอยู่ในคอนโซล ให้เลือก Google Wallet API ในหัวข้อ แล้วเลือกการลงชื่อเข้าใช้บัตรของขวัญในหัวข้อย่อย
พัฒนาหน้าลงชื่อเข้าใช้ที่ใช้ข้อมูลผู้ใช้ Google Wallet
เมื่อผู้ใช้เลือกเพิ่มบัตรของขวัญ ระบบจะนำผู้ใช้ไปยังหน้าที่ปรับให้เหมาะกับผู้ใช้ในเว็บไซต์เพื่อดำเนินการลงชื่อเข้าใช้ให้เสร็จสมบูรณ์
คุณต้องระบุ URL การลงชื่อเข้าใช้ที่ผู้ใช้จะลงชื่อเข้าใช้บัญชีที่มีอยู่ได้
หน้าลงชื่อเข้าใช้ต้องเป็นไปตามข้อกำหนดต่อไปนี้
- มอบประสบการณ์การใช้งานที่เหมาะกับอุปกรณ์เคลื่อนที่แก่ผู้ใช้
- อนุญาตให้ผู้ใช้ลงชื่อเข้าใช้ให้เสร็จสมบูรณ์ภายในหน้าเดียว
- ใช้การเข้ารหัส
HTTPSด้วยใบรับรองที่ถูกต้องเพื่อให้มั่นใจว่าข้อมูลผู้ใช้ได้รับการส่งอย่างปลอดภัย - ตรวจสอบว่าหน้าลงชื่อเข้าใช้มีเวลาทํางานอย่างน้อย 99.9%
เมื่อแสดงหน้าลงชื่อเข้าใช้ Google Wallet จะสร้าง WebView ของ Android และส่งคําขอ POST ไปยัง URL ที่คุณระบุ ข้อมูลผู้ใช้ระบุไว้ในพารามิเตอร์ SharedDataType ซึ่งรวมอยู่ในคําขอ POST โดยใช้ประเภทเนื้อหา
application/x-www-form-urlencoded และการเข้ารหัส UTF-8 ค่าของพารามิเตอร์ SharedDataType
คือออบเจ็กต์ JSON ที่เข้ารหัส Base64
ใช้การพุชบัตรของขวัญกลับไปยัง Google Wallet ทันที
เมื่อตรวจสอบสิทธิ์ (ลงชื่อเข้าใช้) แล้ว หน้าเว็บของคุณควรส่งบัตรของขวัญของผู้ใช้กลับไปยัง Google Wallet ทันที
คุณสามารถส่งบัตรของขวัญกลับไปยัง Google Wallet ได้โดยเปลี่ยนเส้นทางไปยังลิงก์ที่เป็นไปตามโครงสร้าง
https://pay.google.com/gp/v/save/{jwt_generated}
ความยาวที่ปลอดภัยสำหรับ URL คือ 2,000 อักขระ ลิงก์ของคุณควรอยู่ภายใต้ขีดจำกัดนี้ ออบเจ็กต์ที่เข้ารหัสใน JWT ควรมีขนาดเล็กและมีเฉพาะข้อมูลที่เจาะจงสำหรับผู้ใช้ พยายามเก็บข้อมูลส่วนใหญ่ไว้ในคลาสของออบเจ็กต์ โดยสร้างออบเจ็กต์นั้นก่อนสร้าง JWT สำหรับออบเจ็กต์ขนาดใหญ่ที่ไม่ตรงกับขีดจำกัด ให้ลองสร้างออบเจ็กต์ใน Google Wallet API ก่อน แล้วส่งเฉพาะรหัสออบเจ็กต์ใน JWT
ขั้นตอนการติดต่อสื่อสารโดยทั่วไป
ขั้นตอนการสื่อสารสำหรับผู้ใช้ที่ลงชื่อเข้าใช้จนเสร็จสมบูรณ์แสดงอยู่ในรูปภาพต่อไปนี้ การดำเนินการทั้งหมดระหว่าง "เซิร์ฟเวอร์ของคุณ" เป็นความรับผิดชอบของคุณในการใช้งาน
ขอการยืนยันและการเปิดใช้งาน
หลังจากทํางานด้านการพัฒนาและทดสอบขั้นตอนการลงชื่อเข้าใช้เสร็จแล้ว ให้ส่งคําขอผ่านวิดเจ็ตติดต่อทีมสนับสนุนของ Google Pay และ Wallet Console
หลังจากการตรวจสอบการติดตั้งใช้งานอย่างเต็มรูปแบบซึ่งยืนยันว่าฟีเจอร์ทำงานได้อย่างถูกต้องเมื่อใช้ร่วมกับแอป Google Wallet แล้ว เราจะเปิดตัวฟีเจอร์ลงชื่อเข้าใช้บัตรของขวัญสำหรับโปรแกรมบัตรของขวัญของคุณต่อสาธารณะ ซึ่งจะช่วยให้ผู้ใช้ทุกคนเห็นโปรแกรมและใช้ฟีเจอร์นี้ได้
เราจะตรวจสอบการติดตั้งใช้งานฟีเจอร์ลงชื่อเข้าใช้ของคุณเป็นระยะๆ เพื่อให้แน่ใจว่าเป็นไปตามข้อกําหนดของฟีเจอร์อย่างต่อเนื่อง เพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ดีที่สุด คุณจะได้รับการแจ้งเตือนหากมีความคลาดเคลื่อนและฟีเจอร์การลงชื่อเข้าใช้อาจถูกปิดใช้จนกว่าปัญหาจะได้รับการแก้ไข
คำถามที่พบบ่อย
- รูปภาพที่ใช้ในโปรแกรมบัตรของขวัญมีข้อกำหนดไหม
- ใช่ รูปภาพควรโฮสต์ใน
HTTPSตำแหน่งเนื่องจากไม่เช่นนั้นรูปภาพจะไม่ปรากฏใน Google Wallet
- ใช่ รูปภาพควรโฮสต์ใน
- มีเครื่องมือที่ช่วยให้การติดตั้งใช้งานและการแก้ไขข้อบกพร่องของ JWT ง่ายขึ้นไหม
- ได้ แพลตฟอร์มต่างๆ เช่น www.jwt.io ให้คุณถอดรหัสและแก้ไขข้อบกพร่องของโทเค็นได้ในระหว่างกระบวนการพัฒนา ซึ่งจะช่วยให้คุณยืนยันเนื้อหาที่ส่งได้ โปรดทราบว่า Google ไม่มีความเกี่ยวข้องและไม่ได้แนะนำบุคคลที่สามดังกล่าวโดยเฉพาะ
- เราจะจัดการข้อมูล SharedDataType ที่เข้ารหัส Base64 อย่างถูกต้องได้อย่างไร
- ตรวจสอบว่าคุณใช้การเข้ารหัส UTF-8 ตลอดกระบวนการ สตริง JSON ได้รับการเข้ารหัส UTF-8 ก่อน จากนั้นจึงเข้ารหัสโดยใช้ android.util.Base64 พร้อมตัวเลือก NO_WRAP และ URL_SAFE ซึ่งสอดคล้องกับส่วนที่ 4 ของ RFC 3548