セッション トークンを使用する

プラットフォームを選択: Android iOS ウェブサービス

セッション トークンは、予測入力検索でのユーザーのクエリと選択フェーズを、請求処理のために個別のセッションにグループ化します。

セッション トークンを作成する

ユーザーは、セッションごとに一意のセッション トークンを生成する必要があります。バージョン 4 の UUID を使用することをおすすめします。

例

ユーザーがクエリを入力すると、キーを数回打つごとに（1 文字ずつではなく）予測入力リクエストが呼び出され、候補のリストが返されます。ユーザーが結果リストから選択を行うと、その選択がリクエストとしてカウントされ、検索中に行われたすべてのリクエストがバンドルされて 1 つのリクエストとしてカウントされます。ユーザーが場所を選択した場合、検索クエリは無料で利用でき、プレイスデータ リクエストのみが課金されます。セッションの開始から数分以内にユーザーが選択を行わなかった場合、検索クエリのみが課金されます。

このイベントフローをアプリの観点から見てみましょう。

  1. ユーザーがクエリの入力を開始し、「Paris, France」を検索します。
  2. アプリはユーザー入力を検出すると、新しいセッション トークン「トークン A」を作成します。
  3. ユーザーが入力すると、API は数文字ごとに自動入力リクエストを行い、それぞれについて候補となる結果の新しいリストを表示します。
    「P」
    「Par」
    「Paris,」
    「Paris, Fr」
  4. ユーザーが選択すると:
  • このクエリによるすべてのリクエストはグループ化され、「トークン A」で表されるセッションに 1 つのリクエストとして追加されます。
  • ユーザーの選択は Place Detail リクエストとしてカウントされ、「トークン A」で表されるセッションに追加されます。
  • セッションが終了し、アプリは「トークン A」を破棄します。

Autocomplete リクエストに対する課金方法については、使用量と課金をご覧ください。