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

セッション トークン

セッション トークンはユーザーが生成した文字列(オブジェクト)であり、Autocomplete (New) の呼び出しをセッションとしてトラッキングします。予測入力(新版)は、セッション トークンを使用して、ユーザーの予測入力検索のクエリフェーズと選択フェーズを、請求処理のために個別のセッションにグループ化します。

ユーザーは、セッションごとにセッション トークンを作成する必要があります。セッション トークンは、URL とファイル名に使用できる base64 文字列である必要があります。ユーザーは任意の方法でセッション トークンを生成できますが、セッション トークンにはバージョン 4 の UUID(Universally Unique Identifier)を使用することをおすすめします。

セッションは Autocomplete (New) の呼び出しで開始し、Place Details (New) または Address Validation の呼び出しで終了します。各セッションは複数の Autocomplete(新)クエリを持つことができ、その後に Place Details(New)または Address Validation に対する 1 つのリクエストが続きます。セッション内の各リクエストで使用される API キーは、同じ Google Cloud Console プロジェクトに属している必要があります。

セッション トークンは次のように終了します。

  • Place Details (New) が呼び出されます。
  • Address Validation が呼び出されます。
  • セッションは放棄されます。

セッションが終了するとトークンは無効になるため、アプリは新しいセッションごとに新しいトークンを生成する必要があります。sessionToken パラメータを省略した場合、またはセッション トークンを再利用する場合は、セッション トークンが指定されていない場合と同様に新しいセッションが課金されます(各リクエストは個別に課金されます)。

予測入力(新)リクエストの課金方法については、予測入力(新)とセッションの料金をご覧ください。