리뷰
client.reviews를 통해 리뷰를 조회하고, 답글을 게시 및 수정하고, 분석 데이터를 가져옵니다.
모든 리뷰 메서드는 client.reviews에 있습니다. 리뷰 분석은 중첩된 하위 리소스인 client.reviews.analytics에 있습니다.
읽기 메서드는 APIObject(점 표기법을 통한 접근, dict 방식의 접근, .get(), .to_dict()), APIObject 목록 또는 페이지로 나뉜 결과를 위한 SyncPage를 반환합니다. 쓰기 메서드(respond, edit_response, archive_response, edit_settings)는 HTTP 상태가 200이더라도 플랫폼이 변경을 거부하면 ValidationError를 발생시키므로, 결과의 성공 플래그를 확인할 필요가 없습니다.
reviews.list
선택적 필터를 적용하여 사업장의 리뷰 목록을 조회합니다. SyncPage를 반환합니다.
client.reviews.list( location_id: str | int, *, first: int | None = None, after: str | None = None, before: str | None = None, last: int | None = None, site_urls: list[str] | None = None, start_date: str | None = None, end_date: str | None = None, category: str | None = None, rating_filters: list[int] | None = None,) -> SyncPage# Recent reviewspage = client.reviews.list(16808, first=10)for review in page: print(review.rating, review.authorName) # 1- and 2-star only, this yearpage = client.reviews.list( 16808, rating_filters=[1, 2], start_date="2026-01-01", first=50,) # Auto-paginate all reviewsfor review in client.reviews.list(16808, first=100).auto_paging_iter(): print(review.content)reviews.details
상호작용 ID로 특정 리뷰의 상세 정보를 조회합니다. 상호작용 ID는 reviews.list이 반환하는 항목의 interactionId 필드에서 가져옵니다.
client.reviews.details(interaction_ids: list[str]) -> APIObjectdetails = client.reviews.details(["uuid-1", "uuid-2"])print(details.to_dict())reviews.respond
리뷰에 답글을 게시합니다.
client.reviews.respond(interaction_id: str, content: str) -> APIObjectresult = client.reviews.respond( interaction_id="review-uuid", content="Thank you for your feedback, we really appreciate it!",)print(result.to_dict())reviews.edit_response
기존 답글을 수정합니다.
client.reviews.edit_response( review_id: str, response_id: str, content: str,) -> APIObjectclient.reviews.edit_response( review_id="review-uuid", response_id="response-uuid", content="Updated reply text.",)reviews.archive_response
답글을 보관 처리(숨김)합니다.
client.reviews.archive_response(response_id: str) -> APIObjectclient.reviews.archive_response("response-uuid")reviews.settings
사업장의 리뷰 출처 설정을 조회합니다.
client.reviews.settings(location_id: str | int) -> APIObjectsettings = client.reviews.settings(16808)print(settings.to_dict())reviews.edit_settings
사업장의 리뷰 출처 URL을 업데이트합니다. 각 항목은 리뷰 페이지 1개를 설명하는 dict입니다.
client.reviews.edit_settings( location_id: str | int, site_urls: list[dict],) -> APIObjectclient.reviews.edit_settings(16808, site_urls=[ {"url": "https://www.google.com/maps/...", "active": True},])reviews.site_config
계정에서 사용할 수 있는 리뷰 사이트를 조회합니다.
client.reviews.site_config() -> list[APIObject]sites = client.reviews.site_config()for site in sites: print(site.to_dict())reviews.phrases
리뷰에서 추출한 자주 언급되는 문구를 조회합니다. base64 사업장 ID를 전달합니다.
client.reviews.phrases( location_ids: list[str], *, site_urls: list[str] | None = None, start_date: str | None = None, end_date: str | None = None,) -> list[APIObject]phrases = client.reviews.phrases( ["TG9jYXRpb246MTY4MDg=", "TG9jYXRpb246MTQwMjQ="], start_date="2026-01-01", end_date="2026-06-30",)for p in phrases: print(p.to_dict())분석 하위 리소스
reviews.analytics.overview
전체 리뷰 통계(총 리뷰 수, 평균 평점, 답글 작성률)를 조회합니다.
client.reviews.analytics.overview( location_id: str | int, *, start_date: str | None = None, end_date: str | None = None,) -> APIObjectstats = client.reviews.analytics.overview( 16808, start_date="2026-01-01", end_date="2026-06-30",)print(stats.to_dict())reviews.analytics.timeline
시간에 따른 리뷰 분석을 조회합니다.
client.reviews.analytics.timeline( location_id: str | int, *, start_date: str | None = None, end_date: str | None = None,) -> APIObjecttimeline = client.reviews.analytics.timeline( 16808, start_date="2026-01-01", end_date="2026-06-30",)print(timeline.to_dict())reviews.analytics.sites_stats
사이트별(Google, Facebook, Yelp) 리뷰 분석을 조회합니다.
client.reviews.analytics.sites_stats( location_id: str | int, *, start_date: str | None = None, end_date: str | None = None,) -> APIObjectsites = client.reviews.analytics.sites_stats( 16808, start_date="2026-01-01", end_date="2026-06-30",)print(sites.to_dict())