セッション トークン
セッション トークンは、Autocomplete(新規)呼び出しをセッションとして追跡する、ユーザーが生成した文字列(またはオブジェクト)です。予測入力(新版)は、セッション トークンを使用して、ユーザーの予測入力検索のクエリフェーズと選択フェーズを、請求処理のために個別のセッションにグループ化します。
ユーザーは、セッションごとにセッション トークンを作成する必要があります。セッション トークンは、URL とファイル名のセーフな Base64 文字列である必要があります。セッション トークンは任意の方法で生成できますが、セッション トークンには バージョン 4 の Universally Unique Identifier(UUID)を使用することをおすすめします。
セッションは Autocomplete(新規)の呼び出しで始まり、Place Details(新規)またはAddress Validation の呼び出しで終了します。各セッションには、複数の Autocomplete(新規)クエリが含まれ、その後に Place Details(新規)または Address Validation へのリクエストが 1 回含まれます。セッション内の各リクエストに使用する API キーは、同じ Google Cloud コンソール プロジェクトに属している必要があります。
セッション トークンは、次の方法で終了します。
- Place Details (New) が呼び出されます。
- Address Validation が呼び出されます。
- セッションが放棄されます。
セッションが終了すると、トークンは無効になります。アプリでは、新しいセッションごとに新しいトークンを生成する必要があります。sessionToken パラメータを省略する場合や、セッション トークンを再利用する場合は、セッション トークンが指定されていない場合と同様に新しいセッションが課金されます(各リクエストが個別に課金されます)。
予測入力(新)リクエストの課金方法について詳しくは、予測入力(新)とセッションの料金をご覧ください。