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