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

セッション トークン

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

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

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

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

  • Place Details(新規)が呼び出される。
  • Address Validation が呼び出される。
  • セッションが破棄される。

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

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