세션 토큰
세션 토큰은 자동 완성 (신규) 호출을 세션으로 추적하는 사용자 생성 문자열 (또는 객체)입니다. Autocomplete (신규)는 세션 토큰을 사용하여 사용자 자동 완성 검색의 쿼리 및 선택 단계를 결제 목적의 개별 세션으로 그룹화합니다.
사용자는 각 세션의 세션 토큰을 만들어야 합니다. 세션 토큰은 URL 및 파일 이름 안전 base64 문자열이어야 합니다. 사용자는 어떤 방식으로든 세션 토큰을 생성할 수 있지만 Google에서는 세션 토큰에 버전 4 범용 고유 식별자 (UUID)를 사용하는 것이 좋습니다.
세션은 Autocomplete (신규) 호출로 시작하여 Place Details (신규) 또는 Address Validation 호출로 종료됩니다. 세션마다 여러 개의 Autocomplete (New) 쿼리가 포함될 수 있으며 Place Details(New) 또는 Address Validation 요청이 하나씩 뒤에 올 수 있습니다. 세션 내 각 요청에 사용되는 API 키는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다.
세션 토큰은 다음과 같은 방식으로 종료됩니다.
- Place Details (New)가 호출됩니다.
- 주소 확인이 호출됩니다.
- 세션이 중단됩니다.
세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱은 새 세션마다 새 토큰을 생성해야 합니다. sessionToken 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 새 세션에 대해 요금이 청구됩니다 (각 요청에 대해 별도로 요금이 청구됨).
Autocomplete (신규) 요청에 대한 요금 청구 방식에 관한 자세한 내용은 Autocomplete (신규) 및 세션 가격 책정을 참고하세요.