Mã thông báo phiên sẽ nhóm các giai đoạn truy vấn và lựa chọn trong tính năng tự động hoàn thành tìm kiếm của người dùng thành một phiên riêng biệt cho mục đích thanh toán.
Tạo mã thông báo phiên Người dùng chịu trách nhiệm tạo mã thông báo phiên riêng biệt cho mỗi phiên. Bạn nên sử dụng mã nhận dạng duy nhất (UUID) phiên bản 4.
Ví dụ:
Khi người dùng nhập một truy vấn, cứ sau vài lần nhấn phím (không phải mỗi ký tự), một yêu cầu tự động hoàn thành sẽ được gọi và một danh sách kết quả có thể nhận được sẽ được trả về. Khi người dùng đưa ra lựa chọn từ danh sách kết quả, lựa chọn đó sẽ được tính là một yêu cầu và tất cả các yêu cầu được đưa ra trong quá trình tìm kiếm sẽ được nhóm lại và tính là một yêu cầu duy nhất. Nếu người dùng chọn một địa điểm, họ sẽ sử dụng miễn phí cụm từ tìm kiếm và chỉ tính phí đối với yêu cầu Dữ liệu địa điểm. Nếu người dùng không đưa ra lựa chọn trong vòng vài phút đầu phiên, thì chỉ cụm từ tìm kiếm sẽ bị tính phí.
Hãy xem xét luồng sự kiện này từ góc độ một ứng dụng.
- Một người dùng bắt đầu nhập một cụm từ tìm kiếm để tìm kiếm " Paris, Pháp".
- Khi phát hiện hoạt động đầu vào của người dùng, ứng dụng sẽ tạo một mã thông báo phiên mới là "Mã thông báo A".
- Khi người dùng nhập, API sẽ đưa ra yêu cầu tự động hoàn thành cứ vài ký tự một lần, hiển thị danh sách mới các kết quả có thể có cho mỗi:
"P"
"Par"
" Paris,"
" Paris, Fr" - Khi người dùng đưa ra lựa chọn:
- Tất cả các yêu cầu phát sinh từ truy vấn đều được nhóm và thêm vào phiên được biểu thị bằng "Mã thông báo A", dưới dạng một yêu cầu duy nhất.
- Lựa chọn của người dùng được tính là một yêu cầu Thông tin chi tiết về địa điểm và được thêm vào phiên được đại diện bằng "Mã thông báo A".
- Phiên kết thúc và ứng dụng sẽ loại bỏ "Mã thông báo A".
Để biết thêm thông tin về cách tính phí cho các Yêu cầu tự động hoàn thành, hãy xem bài viết Mức sử dụng và thanh toán.