세션 토큰은 자동 완성 (신규) 호출을 세션으로 추적하는 사용자 생성 문자열 (또는 객체)입니다. 자동 완성 (신규)은 세션 토큰을 사용하여 사용자 자동 완성 검색의 쿼리 및 선택 단계를 결제 목적의 개별 세션으로 그룹화합니다.
사용자는 각 세션의 세션 토큰을 만들어야 합니다. 세션 토큰은 URL 및 파일 이름 안전 base64 문자열이어야 합니다. 사용자는 어떤 방식으로든 세션 토큰을 생성할 수 있지만 Google에서는 세션 토큰에 버전 4 범용 고유 식별자 (UUID)를 사용하는 것이 좋습니다.
세션은 Autocomplete (신규) 호출로 시작하여 Place Details (신규) 또는 Address Validation 호출로 종료됩니다. 세션마다 여러 개의 Autocomplete (New) 쿼리가 포함될 수 있으며 Place Details(New) 또는 Address Validation 요청이 하나씩 뒤에 올 수 있습니다. 세션 내 각 요청에 사용되는 API 키는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다.
세션 토큰은 다음과 같은 방식으로 종료됩니다.
Place Details (New)가 호출됩니다.
주소 확인이 호출됩니다.
세션이 중단됩니다.
세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱은 새 세션마다 새 토큰을 생성해야 합니다. sessionToken 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 새 세션에 대해 요금이 청구됩니다 (각 요청에 대해 별도로 요금이 청구됨).
[null,null,["최종 업데이트: 2025-03-01(UTC)"],[[["Session tokens group Autocomplete (New) queries and selection phases into a session for billing purposes, ending with a call to Place Details (New) or Address Validation."],["Session tokens must be URL- and filename-safe base64 strings, with Google recommending the use of version 4 universally unique identifiers (UUIDs)."],["A session begins with an Autocomplete (New) call, allowing for multiple queries within the session before concluding with Place Details (New) or Address Validation."],["Each request within a session must utilize API keys associated with the same Google Cloud Console project, with sessions terminating upon calling Place Details (New), Address Validation, or abandonment."],["Omitting or reusing session tokens results in individual request billing, while fresh tokens are required for each new session to leverage session-based pricing."]]],["Session tokens, user-generated strings, track Autocomplete (New) calls as sessions for billing. Users create tokens, ideally UUIDs, for each session. A session starts with Autocomplete (New) and ends with Place Details (New) or Address Validation, allowing multiple Autocomplete queries. The API keys must be from the same project. Omitting the token or reusing it results in per-request billing. Session tokens are invalid after use and can not be exchanged between places API and places API (new) or Address Validation.\n"]]
