セッション トークン

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

Place Autocomplete は、セッション トークンを使用して、ユーザーによるオートコンプリート検索のクエリと選択フェーズを個別のセッションにグループ化し、課金を行います。セッションは、ユーザーがクエリの入力を開始すると開始され、場所を選択して Place Details が呼び出されると終了します。各セッションでは、複数のオートコンプリート クエリの後に 1 つの場所を選択できます。セッション内の各リクエストに使用される API キーは、同じ Google Cloud コンソール プロジェクトに属している必要があります。セッションが終了するとトークンは無効になります。アプリでセッションごとに新しいトークンを生成する必要があります。sessiontoken パラメータを省略した場合や、セッション トークンを再利用する場合は、セッション トークンが指定されていない場合と同様にセッションが課金されます(各リクエストは個別に課金されます)。

次のガイドラインに従うことをおすすめします。

  • すべてのオートコンプリート セッションでセッション トークンを使用します。
  • セッションごとに新しいトークンを生成します。
  • セッション内のすべての Place Autocomplete リクエストと Place Details リクエストに使用する API キーが、同じ Google Cloud コンソール プロジェクトに属していることを確認します。
  • 新しいセッションごとに固有のセッション トークンを渡すようにしてください。複数のセッションで同じトークンを使用すると、リクエストごとに課金されます。

必要に応じて、リクエストからオートコンプリート セッション トークンを省略できます。セッション トークンを省略すると、各リクエストが個別に課金され、Autocomplete - Per Request SKU がトリガーされます。セッション トークンを再利用すると、そのセッションは無効とみなされ、セッション トークンを渡さなかった場合と同様にリクエストが課金されます。

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

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

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

オートコンプリート リクエストの課金方法については、使用量と課金をご覧ください。

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

セッション トークンは、任意のプログラム メカニズムを使用して作成できます。セッション トークンにはバージョン 4 の UUID を使用することをおすすめします。