Mã thông báo phiên

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

Tính năng Tự động hoàn thành địa điểm sử dụng mã phiên để nhóm các giai đoạn truy vấn và lựa chọn của nội dung 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. Phiên bắt đầu khi người dùng bắt đầu nhập truy vấn và kết thúc khi họ chọn một địa điểm và thực hiện lệnh gọi đến Chi tiết địa điểm. Mỗi phiên có thể có nhiều truy vấn tự động hoàn thành, theo sau là một lựa chọn địa điểm. (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 Google Cloud Console. Sau khi một phiên kết thúc, mã thông báo này 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. Nếu tham số sessiontoken bị bỏ qua hoặc nếu bạn sử dụng lại một mã thông báo phiên, thì phiên đó 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).

Bạn nên làm theo các nguyên tắc sau:

  • Sử dụng mã phiên cho tất cả các phiên tự động hoàn thành.
  • Tạo mã thông báo mới cho mỗi phiên.
  • Đảm bảo rằng(các) khoá API dùng cho tất cả yêu cầu Tự động hoàn thành và Thông tin chi tiết về địa điểm trong một phiên đều thuộc cùng một dự án trên Google Cloud Console.
  • Hãy nhớ truyền một mã thông báo phiên duy nhất cho mỗi phiên mới. Việc sử dụng cùng một mã thông báo cho nhiều phiên sẽ khiến mỗi yêu cầu được tính phí riêng.

Bạn có thể tuỳ ý bỏ qua mã thông báo phiên tự động hoàn thành khỏi yêu cầu. Nếu mã phiên bị bỏ qua, thì mỗi yêu cầu sẽ được lập hoá đơn riêng, kích hoạt SKU Tự động hoàn thành – Theo yêu cầu. Nếu bạn sử dụng lại mã thông báo phiên, phiên đó sẽ bị coi là không hợp lệ và các yêu cầu sẽ bị tính phí như khi bạn không cung cấp mã thông báo phiên nào.

Ví dụ:

Khi người dùng nhập truy vấn, một 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 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 lựa chọn trong danh sách kết quả, lựa chọn đó sẽ được tính là một yêu cầu và tất cả các yêu cầu đưa ra trong quá trình tìm kiếm sẽ được nhóm lại và được 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ì cụm từ tìm kiếm đó sẽ không mất phí và chỉ tính phí cho yêu cầu dữ liệu về Địa điểm. Nếu người dùng không lựa chọn trong vòng vài phút đầu phiên, thì hệ thống chỉ tính phí cụm từ tìm kiếm.

Hãy tìm hiểu luồng sự kiện này từ góc độ của một ứng dụng.

  1. Một người dùng bắt đầu nhập cụm từ để tìm kiếm "Paris, France".
  2. Khi phát hiện hoạt động đầ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 có tên "Token A".
  3. Khi người dùng nhập, cứ sau vài ký tự, API sẽ đưa ra một yêu cầu tự động hoàn thành cho mỗi nội dung:
    "P"
    "Par"
    "Paris",
    "Paris, Fr"
  4. Khi người dùng đưa ra lựa chọn:
    • Tất cả các yêu cầu đến từ truy vấn đều được nhóm lại và thêm vào phiên đượ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 được biểu thị bằng "Mã thông báo A".
  5. Phiên này kết thúc và ứng dụng sẽ loại bỏ "Token A" (Mã thông báo A).

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

Tạo mã thông báo phiên

Để tạo mã phiên, hãy gọi GMSAutocompleteSessionToken.init().