API 참조

Google 리뷰 링크 API

Google 지도 URL 하나를 직접 리뷰 링크로 변환합니다. 가입이나 Google API 키가 필요하지 않습니다.

  1. 요청

    application/json { "maps_url": "https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2" }
  2. POST /api/v1/google-review-link productmate.com

  3. 응답 200

    application/json { "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY", "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY", "verification": "not_verified" }
POST/api/v1/google-review-link

지원 입력

  • 특정 장소의 전체 Google 지도 URL
  • maps.app.goo.gl 공유 링크
  • 기존 goo.gl/maps 공유 링크

요청

엔드포인트에 JSON 객체 하나를 보냅니다. 업체 이름이나 Place ID만 보내는 방식은 지원하지 않습니다.

curl -X POST https://productmate.com/api/v1/google-review-link \
  -H "Content-Type: application/json" \
  -d '{"maps_url":"https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2"}'

응답

{
  "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "verification": "not_verified"
}

verification은 항상 not_verified입니다. 사용자에게 링크를 제공하기 전에 위치를 확인하세요.

오류 및 해결 방법

  • invalid_request (400)
    비어 있지 않은 maps_url이 포함된 유효한 JSON을 보내세요.
  • unsupported_url (422)
    Google 지도에서 특정 업체의 공유 링크를 사용하세요.
  • unsafe_redirect (422)
    Google 지도로만 이동하는 공유 링크를 사용하세요.
  • upstream_unresolved (502)
    짧은 링크를 열고 최종 전체 지도 URL을 보내세요.
  • upstream_timeout (504)
    기다린 후 한 번 다시 시도하거나 최종 전체 지도 URL을 보내세요.

사용 한도

익명 한도는 클라이언트 IP당 분당 약 20회입니다. 같은 IP를 쓰는 에이전트는 이 한도를 공유합니다.

Content-Length: 16 KiB
maps_url: 8 KiB
short_url_resolution_deadline: 10 s

에지에서 생성된 429 응답에는 JSON 또는 Retry-After가 없을 수 있습니다. 최소 60초 기다린 후 대기 시간을 늘리세요.

올바른 지도 URL 찾기

  1. Google 지도에서 정확한 업체 위치를 엽니다.
  2. 지점 이름과 주소를 확인한 후 공유를 선택합니다.
  3. 링크를 복사하여 maps_url로 전송합니다.

데이터 사용

성공한 호출은 장소 식별자, 언어, 시간 및 가능한 경우 사업장의 대략적인 위치를 기록합니다. 확인된 단축 URL은 24시간 동안 캐시됩니다.