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 giá trị nhận dạng duy nhất chung (UUID) phiên bản 4 cho mã thông báo phiên.
Phiên hoạt động bắt đầu bằng 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 điền (Mới), theo sau là một yêu cầu về 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.
Lệnh gọi Address Validation (Xác thực địa chỉ) được thực hiện.
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ệ; ứ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 thông 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).
[null,null,["Cập nhật lần gần đây nhất: 2025-03-01 UTC."],[[["Session tokens group Autocomplete (New) queries and selection phases into a session for billing purposes, ending with a call to Place Details (New) or Address Validation."],["Session tokens must be URL- and filename-safe base64 strings, with Google recommending the use of version 4 universally unique identifiers (UUIDs)."],["A session begins with an Autocomplete (New) call, allowing for multiple queries within the session before concluding with Place Details (New) or Address Validation."],["Each request within a session must utilize API keys associated with the same Google Cloud Console project, with sessions terminating upon calling Place Details (New), Address Validation, or abandonment."],["Omitting or reusing session tokens results in individual request billing, while fresh tokens are required for each new session to leverage session-based pricing."]]],["Session tokens, user-generated strings, track Autocomplete (New) calls as sessions for billing. Users create tokens, ideally UUIDs, for each session. A session starts with Autocomplete (New) and ends with Place Details (New) or Address Validation, allowing multiple Autocomplete queries. The API keys must be from the same project. Omitting the token or reusing it results in per-request billing. Session tokens are invalid after use and can not be exchanged between places API and places API (new) or Address Validation.\n"]]