Oturum jetonları, kullanıcı otomatik tamamlama aramasının sorgu ve seçim aşamalarını faturalandırma amacıyla ayrı bir oturumda gruplandırır.
Oturum jetonu oluşturma
Her oturum için benzersiz oturum jetonları oluşturmaktan kullanıcılar sorumludur.
Google, sürüm 4 UUID'lerinin kullanılmasını önerir.
Örnek
Kullanıcı bir sorgu yazarken birkaç tuş vuruşunda bir otomatik tamamlama isteği çağrılır (karakter başına değil) ve olası sonuçların listesi döndürülür. Kullanıcı sonuç listesinden bir seçim yaptığında bu seçim bir istek olarak sayılır ve arama sırasında yapılan tüm istekler birleştirilerek tek bir istek olarak sayılır. Kullanıcı bir yer seçerse arama sorgusu ücretsizdir ve yalnızca yer verisi isteği için ücret alınır. Kullanıcı, oturumun başlangıcından sonraki birkaç dakika içinde bir seçim yapmazsa yalnızca arama sorgusu için ödeme alınır.
Bu etkinlik akışını bir uygulamanın bakış açısından inceleyelim.
Kullanıcı, "Paris, Fransa" araması yapmak için bir sorgu yazmaya başlar.
Uygulama, kullanıcı girişini algıladıktan sonra "A jetonu" adlı yeni bir oturum jetonu oluşturur.
Kullanıcı yazarken API birkaç karakterde bir otomatik tamamlama isteği gönderir ve her bir karakter için olası sonuçların yeni bir listesini gösterir:
"P"
"Par"
"Paris,"
"Paris, Fr"
Kullanıcı bir seçim yaptığında:
Sorgudan kaynaklanan tüm istekler gruplandırılır ve "A jetonu" ile temsil edilen oturuma tek bir istek olarak eklenir.
Kullanıcının seçimi bir yer ayrıntısı isteği olarak sayılır ve "A jetonu" ile temsil edilen oturuma eklenir.
Oturum sona erer ve uygulama "A jetonu"nu atar.
Otomatik tamamlama isteklerinin nasıl faturalandırıldığı hakkında daha fazla bilgi için Kullanım ve Faturalandırma başlıklı makaleyi inceleyin.
[null,null,["Son güncelleme tarihi: 2025-02-28 UTC."],[[["Session tokens associate autocomplete search queries and selections for billing, ensuring accurate charges based on user interactions."],["Each new search session requires a unique, user-generated token, ideally a version 4 UUID, to track related requests."],["Autocomplete 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."],["If no selection is made within a few minutes, only the search query is billed, attributing costs to the initial search activity."],["Session tokens are project-specific, allowing reuse across different Google Cloud projects but requiring uniqueness within the same project for proper billing."]]],["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"]]
