Mã phiên

Mã phiên là các chuỗi (hoặc đối tượng) do người dùng tạo ra, dùng để 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ã phiên để nhóm các giai đoạn truy vấn và 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 tính phí.

Người dùng chịu trách nhiệm tạo mã phiên cho mỗi phiên. Mã 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ã 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 danh duy nhất toàn cầu (UUID) phiên bản 4 cho mã 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 tính năng Chi tiết đị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), 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ã phiên sẽ kết thúc theo những cách sau:

• Chi tiết địa điểm (Mới) được gọi.
• Xác thực địa chỉ được gọi.
• Phiên bị huỷ bỏ.

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ã phiên, thì phiên mới sẽ bị tính phí như thể không có mã 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í 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.