세션 토큰

세션 토큰은 자동 완성 (신규) 호출을 세션으로 추적하는 사용자 생성 문자열입니다. Autocomplete (New)는 세션 토큰을 사용하여 결제 목적으로 사용자 자동 완성 검색의 쿼리 및 선택 단계를 개별 세션으로 그룹화합니다.

사용자는 각 세션의 세션 토큰을 생성할 책임이 있습니다. 세션 토큰은 URL 및 파일 이름 보안 base64 문자열이어야 합니다. Google은 세션 토큰에 버전 4 범용 고유 식별자 (UUID) 사용을 권장하지만 사용자는 어떤 방식으로든 세션 토큰을 생성할 수 있습니다.

세션은 Autocomplete (New) 호출로 시작하여 Place Details (New) 또는 Address Validation 호출로 종료됩니다. 세션마다 여러 개의 자동 완성 (신규) 쿼리가 포함될 수 있으며, 장소 세부정보(신규) 또는 주소 검증에 대한 요청이 한 번만 수행됩니다. 세션 내에서 각 요청에 사용되는 API 키는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다.

세션 토큰은 다음과 같은 방식으로 종료됩니다.

  • Place Details (New)가 호출됩니다.
  • 주소 확인이 호출됩니다.
  • 세션이 포기됩니다.
세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱은 새 세션마다 새 토큰을 생성해야 합니다. sessionToken 매개변수가 생략되거나 세션 토큰을 재사용하면 세션 토큰이 제공되지 않은 것처럼 새 세션에 대한 요금이 청구됩니다 (각 요청에 대한 요금이 별도로 청구됨). Autocomplete (New) 요청에 대한 요금 청구 방법에 대한 자세한 내용은 Autocomplete (New) 및 세션 가격 책정을 참고하세요.