คำถามที่พบบ่อยเกี่ยวกับ Google Wallet API

เริ่มต้นใช้งาน

Google Wallet API คืออะไร

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

ฉันจะตั้งค่าสภาพแวดล้อมการพัฒนาตามความต้องการทางธุรกิจและความซับซ้อนได้อย่างไร

ด้านล่างนี้คือคำแนะนำที่ใช้ในการตั้งค่าสภาพแวดล้อมการพัฒนาที่รองรับความซับซ้อนและความปลอดภัยของธุรกิจในระดับต่างๆ ได้ การใช้บัญชีบริการหลายบัญชีช่วยให้นักพัฒนาแอปสร้างสภาพแวดล้อมการทดสอบแยกจากสภาพแวดล้อมการใช้งานจริงได้

ความซับซ้อนในการตั้งค่าพื้นฐาน

บัญชีคอนโซลธุรกิจ 1 บัญชีหรือบัญชีหลักของคอนโซลธุรกิจ 1 บัญชีกับบัญชีผู้ออกบัตรหลายบัญชี

  • ตัวเลือกนี้ช่วยให้ใช้แนวทางการจัดการจากส่วนกลางได้โดยใช้บัญชีหลัก 1 บัญชีที่มีธุรกิจย่อย/ผู้ออกบัตรตั้งแต่ 0 รายไปจนถึงหลายราย
  • 1 โปรเจ็กต์ Google Cloud
  • ข้อมูลเข้าสู่ระบบบัญชีบริการ 1 รายการ
  • กลุ่มผู้ใช้กลุ่มเดียว

ความซับซ้อนในการตั้งค่าโดยเฉลี่ย

บัญชีหลัก 1 บัญชีต่อบัญชีผู้ออกบัตรหลายบัญชี

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

ความซับซ้อนของการตั้งค่าที่ซับซ้อน

บัญชีหลัก 1 บัญชีต่อบัญชีผู้ออกบัตรหลายบัญชี

  • ตัวเลือกนี้ช่วยให้ใช้แนวทางการจัดการจากส่วนกลางได้โดยใช้บัญชีหลัก 1 บัญชีที่มีธุรกิจย่อยหลายธุรกิจ
  • โปรเจ็กต์ Google Cloud 1 โปรเจ็กต์ต่อหลายโปรเจ็กต์
  • ผู้ใช้คอนโซลธุรกิจที่ไม่ซ้ำกันต่อผู้ออกใบรับรอง
  • ข้อมูลเข้าสู่ระบบบัญชีบริการ 1 รายการต่อหลายรายการ
    • ข้อมูลเข้าสู่ระบบ PROD 1 รายการต่อธุรกิจ/ผู้ออกใบรับรอง
    • ข้อมูลเข้าสู่ระบบ DEV 1 รายการต่อธุรกิจ/ผู้ออกบัตร

ติดต่อทีมสนับสนุน

การทำงานกับบัตร

ฉันจะลบคลาสหรือออบเจ็กต์ได้อย่างไร

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

ฉันจะจัดกลุ่มบัตรหลายใบเข้าด้วยกันได้อย่างไร

การใช้ GroupingID จะช่วยให้จัดกลุ่มบัตรเข้าด้วยกันได้ง่าย

ฉันจะอัปเดตเฉพาะบางส่วนของบัตรได้อย่างไร

โปรดดูคู่มือประสิทธิภาพเพื่อทำความเข้าใจวิธีดำเนินการอัปเดตบางส่วนโดยใช้คำขอ PATCH

ฉันจะสร้างบัตรหลายรายการพร้อมกันได้ไหม

โปรดดูคู่มือประสิทธิภาพเพื่อทำความเข้าใจวิธีส่งคำขอแบบกลุ่มโดยใช้ API

คำถามทั่วไป

อัตราการจำกัดคำขอที่ส่งไปยัง Google Wallet API คือเท่าใด

การเรียกใช้ Google Wallet API จะถูกจำกัดอัตราการใช้งานไว้ที่ 20 คำขอต่อวินาที

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

เหตุใดจึงห้ามใช้รูปภาพส่วนตัวในบัตรใน Google Wallet

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

Google Wallet API แสดงรหัสข้อผิดพลาดใด

ดูรายการรหัสข้อผิดพลาดและข้อยกเว้นที่ Google Wallet API แสดงได้ที่รหัสข้อผิดพลาด

ฉันจะเปิดใช้ข้อความ Push ได้อย่างไร

Google Wallet ยังไม่รองรับข้อความ Push ที่นักพัฒนาแอปเขียนขึ้นในขณะนี้ อย่างไรก็ตาม Google Wallet จะส่งการแจ้งเตือนที่ทันท่วงทีสำหรับบัตรต่อไปนี้ Google Wallet ยังไม่รองรับข้อความ Push ที่นักพัฒนาแอปเขียนขึ้นในขณะนี้

ประเภทธุรกิจ การแจ้งเตือน เรียกให้แสดงแล้ว เอกสารประกอบ
กิจกรรม การช่วยเตือนเร็วๆ นี้ 3 ชั่วโมงก่อนวันที่มีกิจกรรม เอกสาร
บอร์ดดิ้งพาส การช่วยเตือนเร็วๆ นี้ 3 ชั่วโมงก่อนเวลาออกเดินทางของเที่ยวบิน เอกสาร
บอร์ดดิ้งพาส อัปเดตบัตร การเปลี่ยนแปลงอาคารผู้โดยสาร ต้นทาง ประตูขึ้นเครื่อง เวลาขึ้นเครื่อง หรือเวลาออกเดินทาง เอกสาร
บัตรข้อเสนอ การช่วยเตือนเรื่องการหมดอายุ 48 ชั่วโมงก่อนบัตรข้อเสนอจะหมดอายุ เอกสาร
Generic การช่วยเตือนเร็วๆ นี้ 24 ชั่วโมงก่อนที่ "ช่วงเวลา" จะเริ่มขึ้น เอกสาร
Generic การช่วยเตือนเรื่องการหมดอายุ 48 ชั่วโมงก่อนที่ "ช่วงเวลาภายใน" จะสิ้นสุด เอกสาร

ลบรหัสผู้ขายได้ไหม

ปัจจุบันคุณไม่สามารถลบหรือเก็บรหัสผู้ขายจาก Google Pay และ Wallet Console

ฉันจะใช้ฟีเจอร์ Applinking ได้อย่างไร

การเชื่อมโยงแอปต้องใช้รายการที่อนุญาต ซึ่งขอได้ที่นี่

Google Wallet รองรับ Geofencing ไหม

ขณะนี้ยังไม่รองรับการกำหนดขอบเขตทางภูมิศาสตร์

ฉันจะตั้งค่าโปรแกรมสะสมคะแนนได้อย่างไร

คุณตั้งค่าโปรแกรมการลงทะเบียนและโปรแกรมสะสมคะแนนได้โดยทำตามคำแนะนำนี้

ฉันจะส่งโลโก้ให้ Google สำหรับบัตรขนส่งได้อย่างไร

โปรดใช้แบบฟอร์มนี้เพื่อส่งโลโก้ให้ Google เพิ่มในรายการที่อนุญาต

วิธีจัดการข้อมูล userProfile ที่เข้ารหัส Base64 อย่างถูกต้อง

ตรวจสอบว่าคุณใช้การเข้ารหัส UTF-8 ตลอดกระบวนการ สตริง JSON จะได้รับการเข้ารหัส UTF-8 ก่อน จากนั้นจึงเข้ารหัสโดยใช้ android.util.Base64 ด้วยตัวเลือก NO_WRAP และ URL_SAFE ซึ่งสอดคล้องกับส่วนที่ 4 ของ RFC 3548

ฉันจะสร้างบัญชีผู้ออกบัตรโดยใช้โปรแกรมได้อย่างไร

ดูคู่มือนี้เพื่อสร้างบัญชีผู้ออกบัตรผ่าน API

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

ฉันต้องมีเครื่องอ่าน NFC พิเศษสำหรับบัตร Google SmartTap ไหม

โดยต้องเป็นเครื่องที่รองรับ SmartTap ดูรายชื่อผู้ให้บริการที่ได้รับการรับรองได้ที่นี่

ฉันจะทำให้บัตรทำงานร่วมกับ NFC ได้อย่างไร

โปรดทำตามการกำหนดค่านี้เพื่อให้บัตรของคุณแลกรับข้อเสนอผ่าน Smart Tap ได้

โทเค็นเว็บ JSON (JWT)

มีเครื่องมือที่ช่วยลดความซับซ้อนในการติดตั้งใช้งานและการแก้ไขข้อบกพร่องของ JWT ไหม

ได้ แพลตฟอร์มอย่าง www.jwt.io ช่วยให้คุณถอดรหัสและแก้ไขข้อบกพร่องของโทเค็นได้ในระหว่างกระบวนการพัฒนา ซึ่งจะช่วยให้คุณยืนยันเนื้อหาที่ส่งได้ โปรดทราบว่า Google ไม่มีส่วนเกี่ยวข้องและไม่ได้แนะนำบุคคลที่สามรายใดรายหนึ่งโดยเฉพาะ

คุณ สร้างชั้นเรียนและออบเจ็กต์ล่วงหน้า ได้โดยใช้ API ก่อนสร้างลิงก์บันทึกบัตร (JWT)

การแก้ปัญหา

เหตุใดการตั้งค่าเวลาจึงแสดงเวลาของกิจกรรมไม่ถูกต้อง

เวลาที่แสดงในบัตรคือเวลาท้องถิ่นของกิจกรรม โดยมีการชดเชยสำหรับเวลาที่กิจกรรมจัดขึ้น

โลโก้ของฉันไม่แสดงในบัตรที่ฉันสร้าง ปัญหานี้เกิดจากอะไร

  • ก่อนอื่น ตรวจสอบว่าโลโก้เป็นไปตามหลักเกณฑ์และบันทึกในรูปแบบ PNG
  • ตรวจสอบว่าโลโก้พร้อมใช้งานและมีความน่าเชื่อถือสูง อย่าเปลี่ยนเส้นทางไปยังไฟล์รูปภาพซึ่งอาจทำให้เกิดข้อผิดพลาด 404 รูปภาพควรโฮสต์ในตำแหน่ง HTTPS เนื่องจากจะไม่แสดงใน Google Wallet หากไม่ได้โฮสต์ในตำแหน่งดังกล่าว
  • ตรวจสอบว่าได้ตั้งค่าช่องที่ต้องกรอกทั้งหมดซึ่งทำเครื่องหมายว่าต้องกรอกใน API ไว้ในบัตรแล้ว

การสนับสนุนและความคิดเห็น

ฉันจะติดต่อทีมสนับสนุนด้านเทคนิคได้อย่างไร

หากต้องการความช่วยเหลือเพิ่มเติม โปรดติดต่อทีมสนับสนุนโดยคลิกปุ่ม "ติดต่อทีมสนับสนุน" ในแถบด้านข้างซ้ายของคอนโซล Google Pay และ Wallet

ฉันจะแสดงความคิดเห็นเกี่ยวกับผลิตภัณฑ์ได้อย่างไร

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

ฉันจะแสดงความคิดเห็นเกี่ยวกับเอกสารประกอบได้อย่างไร

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