评价
通过 client.reviews 列出评价、发布和编辑回复，并获取分析数据。
所有评价方法都位于 client.reviews 下。评价分析位于嵌套的 client.reviews.analytics 子资源下。
读取方法返回一个 APIObject（支持点号访问、字典访问、.get()、.to_dict()）、一个包含 APIObject 的列表，或一个用于分页结果的 SyncPage。如果平台拒绝更改，写入方法（respond、edit_response、archive_response、edit_settings）会抛出 ValidationError，即使 HTTP 状态码为 200 也是如此，因此您无需检查结果中的成功标志。
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。每个条目都是一个描述单个评价页面的 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())