Oturum jetonlarını kullanma

Oturum jetonları, faturalandırma amacıyla bir kullanıcı otomatik tamamlama aramasının sorgu ve seçim aşamalarını 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, seçim bir istek olarak sayılır ve arama sırasında yapılan tüm istekler gruplanır ve tek bir istek olarak sayılır. Kullanıcı bir yer seçerse, arama sorgusu ücretsiz olarak sunulur ve yalnızca Yer verileri isteği için ücret alınır. Kullanıcı oturumun başlangıcından birkaç dakika sonra seçim yapmazsa yalnızca arama sorgusu ücretlendirilir.

Şimdi bu etkinlik akışını bir uygulama açısından inceleyelim.

  1. Bir kullanıcı "Paris, Fransa"yı aramak için bir sorgu yazmaya başlıyor.
  2. Kullanıcı girişi algılandıktan sonra uygulama, "A Jetonu" adlı yeni bir oturum jetonu oluşturur.
  3. Kullanıcı yazarken API, birkaç karakterde bir otomatik tamamlama isteği gönderir ve her karakter için potansiyel sonuçların yeni bir listesini gösterir:
    "P"
    "Par"
    "Paris,"
    "Paris, Cuma"
  4. Kullanıcı bir seçim yaptığında:
    • Sorgudan kaynaklanan tüm istekler gruplanır ve "A Jetonu" ile temsil edilen oturuma tek bir istek olarak eklenir.
    • Kullanıcının seçimi Yer Ayrıntısı isteği olarak sayılır ve "A Jetonu" ile temsil edilen oturuma eklenir.
  5. Oturum sona erer ve uygulama "A Jetonu"nu siler.

Otomatik Tamamlama isteklerinin nasıl faturalandırıldığı hakkında daha fazla bilgi için Kullanım ve Faturalandırma sayfasına bakın.