Oturum jetonlarını kullanma

Platform seçin: Android iOS Web Hizmeti

Oturum jetonları, faturalandırma amacıyla bir kullanıcının 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şturmak kullanıcıların sorumluluğundadır. Google, sürüm 4 UUID'leri kullanmanızı önerir.

Örnek

Kullanıcı sorgu yazarken birkaç tuş vuruşunda bir (karakter başına değil) otomatik tamamlama isteği çağrılır ve olası sonuçların listesi döndürülür. Kullanıcı sonuç listesinden seçim yaptığında bu seçim istek olarak sayılır ve arama sırasında yapılan tüm istekler tek bir istek olarak paketlenip sayılır. Kullanıcı bir yer seçerse arama sorgusu ücretsiz olarak sunulur ve yalnızca yer verileri isteği ücretlendirilir. Kullanıcı, oturumun başlamasından sonraki birkaç dakika içinde seçim yapmazsa yalnızca arama sorgusu için ödeme alınır.

Bu etkinlik akışını bir uygulama açısından inceleyelim.

  1. Kullanıcı, "Paris, Fransa"yı aramak için bir sorgu yazmaya başlar.
  2. Uygulama, kullanıcı girişini algıladığında yeni bir oturum jetonu ("Jeton A") oluşturur.
  3. Kullanıcı yazarken API, her birkaç karakterde bir otomatik tamamlama isteği göndererek her biri için yeni bir potansiyel sonuç listesi gösterir:
    "P"
    "Par"
    "Paris,"
    "Paris, Fr"
  4. Kullanıcı 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, Yer Ayrıntıları 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 başlıklı makaleyi inceleyin.