コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
この機能を使用するには、Places API の次世代版である Places API(新版)を有効にする必要があります。詳細については、API を有効にする をご覧ください。
セッション トークン
セッション トークンは、Autocomplete(新版) の呼び出しをセッション として追跡するユーザー生成の文字列(またはオブジェクト)です。予測入力(新規)はセッション トークンを使用し、請求処理のために予測入力検索でのユーザーのクエリと選択フェーズを個別のセッションにグループ化します。
ユーザーは、セッションごとにセッション トークンを作成する責任があります。セッション トークンは、URL およびファイル名セーフの Base64 文字列である必要があります。ユーザーは任意の方法でセッション トークンを生成できますが、Google はセッション トークンにバージョン 4 の UUID(Universally Unique Identifier) を使用することをおすすめします。
セッションは Autocomplete(新規)の呼び出しで始まり、Place Details(新規) または住所の検証 の呼び出しで終了します。セッションによっては、複数の Autocomplete(新版)クエリが入力された後に、Place Details(新版)または Address Validation へのリクエストが 1 回行われる場合もあります。セッション内の各リクエストで使用される API キーは、同じ Google Cloud Console プロジェクトに属している必要があります。
注: セッション トークンは、Places API(Legacy)エンドポイントと Places API(New)または Address Validation エンドポイントの間で交換できません。たとえば、Place Autocomplete(Legacy) リクエストの後に、同じセッションで Place Details(Legacy)リクエストを続けることはできますが、同じセッションで Place Details(New)リクエストや Address Validation リクエストを続けることはできません。セッション トークンは次の方法で終了します。
Place Details(新版)が呼び出されます。
Address Validation が呼び出されます。
セッションが破棄されます。
セッションが終了すると、トークンは無効になります。アプリでは、新しいセッションごとに新しいトークンを生成する必要があります。sessionToken
パラメータを省略する場合や、セッション トークンを再利用する場合は、セッション トークンが指定されていない場合と同様に新しいセッションが課金されます(各リクエストが個別に課金されます)。
Autocomplete(新版)リクエストの課金方法の詳細については、Autocomplete(新版)とセッションの料金設定 をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンス により使用許諾されます。コードサンプルは Apache 2.0 ライセンス により使用許諾されます。詳しくは、Google Developers サイトのポリシー をご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-09-12 UTC。
[null,null,["最終更新日 2025-09-12 UTC。"],[],["To use this feature, enable Places API (New). Session tokens, which are URL-safe base64 strings (ideally UUIDs), group autocomplete queries and selections into sessions for billing. A session begins with an Autocomplete (New) call and ends with a Place Details (New) or Address Validation call. Each session can contain several autocomplete queries. Tokens are single-use per session; reusing them or omitting them results in per-request billing.\n"],null,[]]