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 otomatik tamamlama isteği her tuş vuruşunda (karakter başına değil) çağrılır 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 bir araya getirilip 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.
Şimdi bu etkinlik akışını bir uygulama açısından inceleyelim.
- Kullanıcı, "Paris, Fransa" araması yapmak için bir sorgu yazmaya başlar.
- Kullanıcı girişi algılandıktan sonra uygulama, "A Jetonu" adlı yeni bir oturum jetonu oluşturur.
- Kullanıcı yazarken API birkaç karakterde bir otomatik tamamlama isteği gönderir ve her biri 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.