Sử dụng mã phiên

Chọn nền tảng: Android iOS Dịch vụ web

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 cụ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.

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. Google khuyên bạn nên sử dụng UUID phiên bản 4.

Ví dụ:

Khi người dùng nhập một cụm từ tìm kiếm, yêu cầu tự động hoàn thành sẽ được gọi sau mỗi vài lần nhấn phím (không phải cho mỗi ký tự) và một danh sách kết quả có thể có sẽ được trả về. Khi người dùng chọn một mục trong danh sách kết quả, lựa chọn đó được tính là một yêu cầu và tất cả các yêu cầu được đưa ra trong quá trình tìm kiếm sẽ được kết hợp và tính là một yêu cầu duy nhất. Nếu người dùng chọn một địa điểm, thì truy vấn tìm kiếm sẽ được cung cấp miễn phí và bạn chỉ phải trả phí cho 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 kể từ khi bắt đầu phiên, thì chỉ truy vấn tìm kiếm mới bị tính phí.

Hãy xem xét luồng sự kiện này từ góc độ của một ứng dụng.

  1. Người dùng bắt đầu nhập một cụm từ tìm kiếm để tìm "Paris, Pháp".
  2. Khi phát hiện thấy dữ liệu đầu vào của người dùng, ứng dụng sẽ tạo một mã thông báo phiên mới, "Mã thông báo A".
  3. Khi người dùng nhập, cứ vài ký tự, API sẽ đưa ra một yêu cầu tự động hoàn thành, hiển thị một danh sách kết quả tiềm năng mới cho từng ký tự:
    "P"
    "Par"
    "Paris"
    "Paris, Fr"
  4. Khi người dùng chọn:
    • Tất cả các yêu cầu phát sinh từ truy vấn đều được nhóm và thêm vào phiên do "Mã thông báo A" đại diện, 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 về địa điểm và được thêm vào phiên do "Mã thông báo A" đại diện.
  5. Phiên kết thúc và ứng dụng loại bỏ "Mã thông báo A".

Để 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, hãy xem phần Mức sử dụng và phí.