Mã thông báo phiên
Mã thông báo phiên là các chuỗi (hoặc đối tượng) do người dùng tạo để theo dõi các lệnh gọi Tự động hoàn thành (Mới) dưới dạng phiên. Tính năng Tự động hoàn thành (Mới) sử dụng mã thông báo phiên để nhóm các giai đoạn truy vấn và lựa chọn của một lượt tìm kiếm tự động hoàn thành của người dùng thành một phiên riêng biệt cho mục đích thanh toán.
Người dùng chịu trách nhiệm tạo mã thông báo phiên cho mỗi phiên. Mã thông báo phiên phải là chuỗi base64 an toàn cho URL và tên tệp. Người dùng có thể tạo mã thông báo phiên theo bất kỳ cách nào, mặc dù Google khuyên bạn nên sử dụng mã nhận dạng duy nhất chung (UUID) phiên bản 4 cho mã thông báo phiên.
Phiên này bắt đầu bằng một lệnh gọi đến tính năng Tự động hoàn thành (Mới) và kết thúc bằng lệnh gọi đến Thông tin chi tiết về địa điểm (Mới) hoặc Xác thực địa chỉ. Mỗi phiên có thể có nhiều truy vấn Tự động hoàn thành (Mới), theo sau là một yêu cầu đến Thông tin chi tiết về địa điểm (Mới) hoặc Xác thực địa chỉ. (Các) khoá API dùng cho mỗi yêu cầu trong một phiên phải thuộc cùng một dự án trên Google Cloud Console.
Mã thông báo phiên hoạt động chấm dứt theo các cách sau:
- Lệnh Place Details (New) (Chi tiết địa điểm (Mới)) được gọi.
- Xác thực địa chỉ được gọi.
- Phiên đã bị bỏ dở.
Sau khi một phiên kết thúc, mã thông báo sẽ không còn hợp lệ nữa; ứng dụng của bạn phải tạo một mã thông báo mới cho mỗi phiên mới. Nếu bạn bỏ qua tham số sessionToken hoặc sử dụng lại mã thông báo phiên, thì phiên mới sẽ được tính phí như thể không có mã thông báo phiên nào được cung cấp (mỗi yêu cầu được tính phí riêng).
Để biết thêm thông tin về cách tính phí các yêu cầu Tự động hoàn thành (Mới), hãy xem bài viết Tự động hoàn thành (Mới) và mức giá theo phiên.