โทเค็นของเซสชัน

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

เราขอแนะนำหลักเกณฑ์ต่อไปนี้

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

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

ตัวอย่าง

เมื่อผู้ใช้พิมพ์ข้อความค้นหา จะมีการเรียกคำขอที่เติมข้อความอัตโนมัติทุกครั้งที่กดแป้นพิมพ์ (ไม่ใช่ต่ออักขระ) และจะแสดงรายการผลลัพธ์ที่เป็นไปได้ เมื่อผู้ใช้เลือกจากรายการผลการค้นหา ระบบจะนับการเลือกเป็นคำขอ และคำขอทั้งหมดที่เกิดขึ้นในระหว่างการค้นหาจะถูกรวมกลุ่มและนับเป็นคำขอเดียว หากผู้ใช้เลือกสถานที่ คำค้นหาจะไม่มีค่าใช้จ่ายและจะมีการเรียกเก็บเงินเฉพาะคำขอข้อมูลสถานที่เท่านั้น หากผู้ใช้ไม่เลือกภายใน 2-3 นาทีนับจากเริ่มต้นเซสชัน ระบบจะเรียกเก็บเงินเฉพาะคำค้นหา

มาดูขั้นตอนของเหตุการณ์นี้จากมุมมองของแอปกัน

1. ผู้ใช้เริ่มพิมพ์ข้อความค้นหาเพื่อค้นหา "ปารีส ฝรั่งเศส"
2. เมื่อตรวจพบอินพุตของผู้ใช้ แอปจะสร้างโทเค็นเซสชันใหม่ "โทเค็น A"
3. เมื่อผู้ใช้พิมพ์ API จะส่งคำขอเติมข้อความอัตโนมัติทุกๆ 2-3 อักขระ โดยแสดงรายการผลลัพธ์ใหม่ที่เป็นไปได้สำหรับแต่ละอักขระดังนี้
   "P"
   "Par"
   "ปารีส"
   "ปารีส, Fr"
   
4. เมื่อผู้ใช้ทำการเลือก
   • ระบบจะจัดกลุ่มคำขอทั้งหมดที่เกิดจากการค้นหาดังกล่าวและเพิ่มลงในเซสชันที่แสดงด้วย "โทเค็น A" เป็นคำขอเดียว
   • การเลือกของผู้ใช้จะนับเป็นคำขอรายละเอียดสถานที่และเพิ่มลงในเซสชันที่แสดงด้วย "โทเค็น A"
5. เซสชันสิ้นสุดลงและแอปทิ้ง "โทเค็น A"

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเรียกเก็บเงินสำหรับคำขอที่เติมข้อความอัตโนมัติได้ที่การใช้งานและการเรียกเก็บเงิน

สร้างโทเค็นของเซสชัน

หากต้องการสร้างโทเค็นเซสชัน โปรดเรียกใช้ GMSAutocompleteSessionToken.init()