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 penekanan tombol (bukan per karakter), dan daftar kemungkinan hasil ditampilkan. Saat
pengguna membuat pilihan dari daftar hasil, pilihan tersebut dihitung sebagai
permintaan, dan semua permintaan yang dibuat selama penelusuran 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
memilih dalam beberapa menit setelah sesi dimulai, hanya
kueri penelusuran yang ditagih.
Mari kita periksa alur peristiwa ini dari perspektif aplikasi.
Pengguna mulai mengetik kueri untuk menelusuri "Paris, Prancis".
Setelah mendeteksi input pengguna, aplikasi membuat token sesi
baru, "Token A".
Saat pengguna mengetik, API akan membuat permintaan pelengkapan otomatis setiap beberapa karakter, menampilkan daftar baru hasil yang mungkin untuk setiap karakter:
"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 membuang "Token A".
Untuk mengetahui informasi selengkapnya tentang cara penagihan permintaan Autocomplete, lihat Penggunaan dan Penagihan.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[[["\u003cp\u003eSession tokens associate autocomplete search queries and selections for billing, ensuring accurate charges based on user interactions.\u003c/p\u003e\n"],["\u003cp\u003eEach new search session requires a unique, user-generated token, ideally a version 4 UUID, to track related requests.\u003c/p\u003e\n"],["\u003cp\u003eAutocomplete requests during a search are grouped and billed as a single request when the user makes a selection, charging only for Place data if a place is chosen.\u003c/p\u003e\n"],["\u003cp\u003eIf no selection is made within a few minutes, only the search query is billed, attributing costs to the initial search activity.\u003c/p\u003e\n"],["\u003cp\u003eSession tokens are project-specific, allowing reuse across different Google Cloud projects but requiring uniqueness within the same project for proper billing.\u003c/p\u003e\n"]]],["Session tokens group user autocomplete searches for billing. Generate unique session tokens (e.g., version 4 UUIDs) per project. As users type, autocomplete requests are made. Upon selection, all requests are bundled into a single, session-token-linked request. If a place is selected, only the Place data request is charged. Otherwise, only the search query is charged. If no selection is made, the session times out, and only the search query is billed. Discard the token after the session.\n"],null,[]]