評論
透過 client.reviews 列出評論、發布及編輯回覆，並取得分析資料。
所有評論方法都位於 client.reviews 下。評論分析位於巢狀的 client.reviews.analytics 子資源下。
讀取方法會傳回 APIObject（支援點號存取、字典存取、.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。每個項目都是描述一個評論頁面的 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())