요약

  • Google 공식 요금 문서는 Autocomplete (New) 세션을 Place Details Essentials (IDs Only)로 마치면 마지막 상세정보 요청은 무료지만 앞선 Autocomplete 요청 전체를 각각 청구한다고 명시한다.
  • 일반 Essentials로 마치면 처음 12회의 Autocomplete는 건별 청구되고 13번째부터는 요금이 없는 세션 사용 SKU에 들어간다. 상세정보 요청에는 별도 요금이 붙는다.

공짜는 마지막 한 칸이다

사용자가 장소 이름을 입력할 때 앱은 후보를 계속 보여준다. 선택이 끝난 뒤 필요한 것이 장소 ID뿐이라면 개발자는 Place Details (New)의 필드를 IDs Only로 지정한다. 반환 데이터가 줄고 마지막 호출의 가격은 0이다. 코드에서는 보기 좋은 절약처럼 보인다.

Google의 세션 요금표는 그 마지막 선택을 앞선 호출에까지 적용한다. Essentials (IDs Only)로 세션을 종료하면 앞서 전송한 모든 Autocomplete 요청이 ‘Autocomplete Requests’로 분류돼 한 건씩 청구된다. Google의 설명대로라면 세션을 쓰지 않은 경우와 같은 방식이다. 세션 토큰이 요청을 묶어 주더라도 어떤 요금 처리를 받을지는 종료 방식이 결정한다.

일반 Essentials로 마치는 경우는 다르다. 처음 12번의 Autocomplete는 개별 청구지만 13번째부터는 무료인 ‘Autocomplete Session Usage’로 넘어간다. 상세정보 호출에는 별도 요금이 있다. Pro나 Enterprise 상세정보 또는 주소 검증으로 끝내면 Autocomplete 전체가 무료 세션 사용에 들어갈 수 있지만 종료 호출은 그에 맞는 더 높은 SKU로 청구된다. 마지막 호출만 보고 어느 설계가 더 싸다고 결론 내릴 수 없다.

이 규칙은 조직 안에서 서로 다른 표를 보는 사람들을 충돌시킨다. 개발자는 필요한 데이터만 받으려 하고, 재무팀은 API 사용료를 관리한다. ‘세션 수’만 세면 어떤 필드 선택이 앞선 검색의 과금 방식을 바꿨는지 보이지 않는다. 비교하려면 세션당 Autocomplete 호출 수, 종료 SKU, 계정에 적용된 실제 단가가 필요하다. Google 공개 문서에는 특정 고객의 호출 구성이나 청구서가 없다.

토큰 상태도 따로 확인해야 한다. Google은 세션마다 새 토큰, 같은 Cloud 프로젝트에 속한 API 키, New 제품군의 호출을 요구한다. 토큰이 없거나 재사용되면 건별 과금이 된다. 완료되지 않은 세션도 Autocomplete가 건별 청구된다. 정상적인 IDs Only 종료와 토큰 오류를 한데 묶으면 원인을 잘못 고치게 된다.

장소 ID는 실제로 무료다. 그곳에 도달하기까지의 검색은 별개다. API 구매자가 물어야 할 것은 마지막 줄의 0원이 아니라 그 이전의 모든 호출이 어느 SKU에 들어갔는가다.

출처