Token sesi mengelompokkan fase kueri dan pemilihan dari penelusuran pelengkapan otomatis pengguna ke dalam sesi terpisah untuk tujuan penagihan.
Membuat token sesi
Pengguna bertanggung jawab untuk membuat token sesi unik untuk setiap sesi. Google merekomendasikan penggunaan UUID versi 4.
Contoh
Saat pengguna mengetik kueri, permintaan pelengkapan otomatis dipanggil setiap beberapa
ketukan tombol (bukan per karakter), dan daftar kemungkinan hasil akan ditampilkan. Saat
pengguna membuat pilihan dari daftar hasil, pilihan tersebut dihitung sebagai
permintaan, dan semua permintaan yang dibuat selama penelusuran akan digabungkan dan dihitung
sebagai satu permintaan. Jika pengguna memilih tempat, kueri penelusuran tersedia tanpa biaya, dan hanya permintaan data Tempat yang dikenai biaya. Jika pengguna tidak
membuat pilihan dalam beberapa menit sejak awal sesi, hanya
kueri penelusuran yang akan ditagih.
Mari kita periksa alur peristiwa ini dari perspektif aplikasi.
Pengguna mulai mengetik kueri untuk menelusuri "Paris, Prancis".
Setelah mendeteksi input pengguna, aplikasi akan membuat token sesi baru, "Token A".
Saat pengguna mengetik, API akan membuat permintaan pelengkapan otomatis setiap beberapa
karakter, yang menampilkan daftar baru potensi hasil untuk setiap:
"P"
"Par"
"Paris,"
"Paris, Fr"
Saat pengguna membuat pilihan:
Semua permintaan yang dihasilkan dari kueri dikelompokkan dan ditambahkan ke sesi
yang diwakili oleh "Token A", sebagai satu permintaan.
Pilihan pengguna dihitung sebagai permintaan Place Detail, dan ditambahkan ke sesi yang diwakili oleh "Token A".
Sesi selesai, dan aplikasi menghapus "Token A".
Untuk mengetahui informasi selengkapnya tentang cara penagihan permintaan Autocomplete, lihat Penggunaan dan
Penagihan.
[null,null,["Terakhir diperbarui pada 2025-02-25 UTC."],[[["Session tokens are used to group autocomplete search queries and selections for billing purposes."],["Each session requires a unique token, ideally a version 4 UUID."],["Autocomplete requests are bundled and billed as a single request when a user makes a selection."],["If no selection is made, only the search query is charged after a few minutes."],["Session tokens can be shared across different Google Cloud projects, but must be unique within a single project."]]],["This document details the use of session tokens with the Places API. A session token groups a user's autocomplete search into a single session for billing. Users must create unique session tokens (version 4 UUIDs recommended) for each session, ensuring uniqueness within a project. Requests are bundled into a session. If a user selects a place, only the place details are charged; otherwise, only the search query is charged. Each session ends after a user's selection or inactivity, at which point the token is discarded.\n"]]
