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

セッション トークン

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

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

セッションは Autocomplete（新規）の呼び出しで始まり、Place Details（新規）または住所検証の呼び出しで終了します。セッションによっては、複数の Autocomplete（新版）クエリが入力された後に、Place Details（新版）または Address Validation へのリクエストが 1 回行われる場合もあります。セッション内の各リクエストで使用される API キーは、同じ Google Cloud Console プロジェクトに属している必要があります。

注: セッション トークンは、Places API エンドポイントと Places API（新版）または Address Validation エンドポイントの間で交換できません。たとえば、Place Autocomplete リクエストの後に同じセッションで Place Details リクエストを続けることはできますが、同じセッションで Place Details（新版）リクエストや Address Validation リクエストを続けることはできません。

セッション トークンは次の方法で終了します。

• Place Details（新版）が呼び出されます。
• Address Validation が呼び出されます。
• セッションが破棄されます。

注: 必要に応じて、リクエストから Autocomplete（新版）セッション トークンを省略できます。セッション トークンを省略すると、各リクエストが個別に課金され、Autocomplete - Per Request SKU が課金されます。

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

Autocomplete（新版）リクエストの課金方法の詳細については、Autocomplete（新版）とセッションの料金設定をご覧ください。