Place Autocomplete จะใช้โทเค็นของเซสชันในการจัดกลุ่มคำค้นหาและเฟสการเลือกของการค้นหาแบบเติมข้อความอัตโนมัติของผู้ใช้เป็นเซสชันที่แยกจากกันเพื่อใช้ในการเรียกเก็บเงิน เซสชันจะเริ่มต้นเมื่อผู้ใช้เริ่มพิมพ์ข้อความค้นหา และสรุปเมื่อผู้ใช้เลือกสถานที่และโทรไปยังรายละเอียดสถานที่ แต่ละเซสชันสามารถมีข้อความค้นหาที่เติมข้อความอัตโนมัติได้หลายรายการ ตามด้วยการเลือกสถานที่เพียงแห่งเดียว คีย์ API ที่ใช้สำหรับแต่ละคำขอภายในเซสชันต้องเป็นของโปรเจ็กต์ Google Cloud Console เดียวกัน เมื่อเซสชันสิ้นสุดลง โทเค็นจะใช้งานไม่ได้อีกต่อไป แอปของคุณต้องสร้างโทเค็นใหม่สำหรับแต่ละเซสชัน หากไม่ระบุพารามิเตอร์ sessiontoken หรือหากคุณใช้โทเค็นเซสชันซ้ำ ระบบจะเรียกเก็บเงินเซสชันเสมือนว่าไม่ได้ระบุโทเค็นเซสชันไว้ (เรียกเก็บเงินคำขอแต่ละรายการแยกกัน)
เราขอแนะนำหลักเกณฑ์ต่อไปนี้
- ใช้โทเค็นเซสชันสําหรับเซสชันการเติมข้อความอัตโนมัติทั้งหมด
- สร้างโทเค็นใหม่สำหรับแต่ละเซสชัน
- ตรวจสอบว่าคีย์ API ที่ใช้สำหรับคำขอการเติมข้อความอัตโนมัติและสถานที่ รายละเอียดสถานที่ทั้งหมดในเซสชันเป็นของโปรเจ็กต์ Google Cloud Console เดียวกัน
- คุณต้องส่งโทเค็นเซสชันที่ไม่ซ้ำกันสำหรับเซสชันใหม่แต่ละเซสชัน การใช้โทเค็นเดียวกันสำหรับเซสชันมากกว่า 1 เซสชันจะส่งผลให้มีการเรียกเก็บเงินกับแต่ละคำขอแยกกัน
คุณจะเลือกละเว้นโทเค็นเซสชันการเติมข้อความอัตโนมัติจากคำขอก็ได้ หากละเว้นโทเค็นเซสชัน ระบบจะเรียกเก็บเงินแต่ละคำขอแยกกัน ซึ่งจะทริกเกอร์ การเติมข้อความอัตโนมัติ - ตามคำขอ SKU หากคุณใช้โทเค็นเซสชันซ้ำ จะถือว่าเซสชันไม่ถูกต้องและจะเรียกเก็บเงินคำขอเสมือนว่าไม่ได้ให้โทเค็นเซสชัน
ตัวอย่าง
เมื่อผู้ใช้พิมพ์ข้อความค้นหา จะมีการเรียกคำขอที่เติมข้อความอัตโนมัติทุกครั้งที่กดแป้นพิมพ์ (ไม่ใช่ต่ออักขระ) และจะแสดงรายการผลลัพธ์ที่เป็นไปได้ เมื่อผู้ใช้เลือกจากรายการผลการค้นหา ระบบจะนับการเลือกเป็นคำขอ และคำขอทั้งหมดที่เกิดขึ้นในระหว่างการค้นหาจะถูกรวมกลุ่มและนับเป็นคำขอเดียว หากผู้ใช้เลือกสถานที่ คำค้นหาจะไม่มีค่าใช้จ่ายและจะมีการเรียกเก็บเงินเฉพาะคำขอข้อมูลสถานที่เท่านั้น หากผู้ใช้ไม่เลือกภายใน 2-3 นาทีนับจากเริ่มต้นเซสชัน ระบบจะเรียกเก็บเงินเฉพาะคำค้นหา
มาดูขั้นตอนของเหตุการณ์นี้จากมุมมองของแอปกัน
- ผู้ใช้เริ่มพิมพ์ข้อความค้นหาเพื่อค้นหา "ปารีส ฝรั่งเศส"
- เมื่อตรวจพบอินพุตของผู้ใช้ แอปจะสร้างโทเค็นเซสชันใหม่ "โทเค็น A"
- เมื่อผู้ใช้พิมพ์ API จะส่งคำขอเติมข้อความอัตโนมัติทุกๆ 2-3 อักขระ โดยแสดงรายการผลลัพธ์ใหม่ที่เป็นไปได้สำหรับแต่ละอักขระดังนี้
"P"
"Par"
"ปารีส"
"ปารีส, Fr"
- เมื่อผู้ใช้ทำการเลือก
- ระบบจะจัดกลุ่มคำขอทั้งหมดที่เกิดจากการค้นหาดังกล่าวและเพิ่มลงในเซสชันที่แสดงด้วย "โทเค็น A" เป็นคำขอเดียว
- การเลือกของผู้ใช้จะนับเป็นคำขอรายละเอียดสถานที่และเพิ่มลงในเซสชันที่แสดงด้วย "โทเค็น A"
- เซสชันสิ้นสุดลงและแอปทิ้ง "โทเค็น A"
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเรียกเก็บเงินสำหรับคำขอที่เติมข้อความอัตโนมัติได้ที่การใช้งานและการเรียกเก็บเงิน
สร้างโทเค็นของเซสชัน
หากต้องการสร้างโทเค็นเซสชัน โปรดเรียกใช้ GMSAutocompleteSessionToken.init()