セッション トークン

セッション トークンは、オートコンプリート(New)呼び出しをセッションとしてトラッキングする、ユーザー生成の文字列(またはオブジェクト)です。オートコンプリート(新機能)は、課金のためにセッション トークンを使用して、ユーザーのオートコンプリート検索のクエリと選択フェーズを個別のセッションにグループ化します。

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

セッションは Autocomplete (New) の呼び出しで始まり、最後に Place Details (New) または Address Validation が呼び出されます。各セッションでは、複数の Autocomplete(New)クエリの後に、Place Details(New)または Address Validation に対するリクエストを 1 回送信できます。セッション内の各リクエストに使用される API キーは、同じ Google Cloud コンソール プロジェクトに属している必要があります。

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

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

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

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