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 ra, 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 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à các 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 toàn cầu (UUID) phiên bản 4 cho mã thông báo phiên.

Phiên 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 một lệnh gọi đến Place Details (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), tiếp theo là một yêu cầu đến tính năng Place Details (Mới) hoặc Xác thực địa chỉ. Khoá API được 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 sẽ kết thúc theo những cách sau:

• Lệnh gọi đến tính năng Chi tiết về địa điểm (Mới).
• Lệnh gọi đến tính năng Xác thực địa chỉ.
• Phiên bị bỏ qua.

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 nếu bạn sử dụng lại mã thông báo phiên, thì phiên mới sẽ bị 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 sẽ được tính phí riêng).

Để 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 (Mới), hãy xem bài viết Giá cho tính năng Tự động hoàn thành (Mới) và phiên.