세션 토큰은 자동 완성 (신규) 호출을 세션으로 추적하는 사용자가 생성한 문자열 (또는 객체)입니다. 자동 완성 (신규)은 세션 토큰을 사용하여 결제 목적으로 사용자 자동 완성 검색의 쿼리 및 선택 단계를 개별 세션으로 그룹화합니다.
사용자는 각 세션의 세션 토큰을 만들어야 합니다. 세션 토큰은 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-01-14(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."]]],[]]
