Sử dụng mã thông báo phiên

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

Mã thông báo phiên hoạt động 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.

Tạo mã thông báo phiên hoạt động

Người dùng chịu trách nhiệm tạo mã thông báo phiên hoạt động riêng biệt cho mỗi phiên hoạt động. 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 truy vấn, yêu cầu tự động hoàn thành sẽ được gọi sau vài lần nhấn phím (không phải 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 kết quả 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 thực hiện trong quá trình tìm kiếm sẽ được nhóm lại 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, truy vấn tìm kiếm sẽ được cung cấp miễn phí và chỉ yêu cầu Dữ liệu địa điểm mới bị tính phí. Nếu người dùng không chọn trong vòng vài phút kể từ khi bắt đầu phiên hoạt động, 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 theo góc độ của một ứng dụng.

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