Mã thông báo phiên sẽ nhóm các giai đoạn truy vấn và lựa chọn trong quá trình tự động hoàn thành của người dùng tìm kiếm vào 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 duy nhấ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ứ vài bước thì một yêu cầu tự động hoàn thành sẽ được gọi thao tác nhấn phím (không phải theo từng ký tự) và một danh sách các kết quả có thể nhận được sẽ được trả về. Thời gian người dùng thực hiện lựa chọn từ danh sách kết quả, lựa chọn được tính là một và tất cả các yêu cầu được đưa ra trong quá trình tìm kiếm đều được nhóm lại và tính dưới dạng một yêu cầu duy nhất. Nếu người dùng chọn một địa điểm, thì cụm từ tìm kiếm sẽ xuất hiện không mất phí và chỉ tính phí 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 sau khi bắt đầu phiên, chỉ có cụm từ tìm kiếm 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 phiên mới mã thông báo "Mã thông báo A".
- Khi người dùng nhập, API sẽ thực hiện yêu cầu tự động hoàn thành cứ vài bước
để hiển thị danh sách mới các kết quả có thể có cho mỗi ký tự:
"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 lại 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 Chi tiết địa điểm và được thêm vào đối với phiên được biểu thị 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 lập hoá đơn cho các Yêu cầu tự động hoàn thành, hãy xem phần Sử dụng và Thanh toán.