レビュー

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 を返します。

Python

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

パラメーター	型	説明
`location_id`	`str \| int`	レビューを一覧表示する拠点を、数値（`16808`）または base64（`"TG9jYXRpb246MTY4MDg="`）で指定します。
`first` / `last`	`int`	結果セットの先頭または末尾から数えるページサイズです。
`after` / `before`	`str`	内部構造を意識せずに使用するページネーションカーソルです。
`site_urls`	`list[str]`	これらのレビューページ URL のレビューのみを対象にします。
`start_date` / `end_date`	`str`	`YYYY-MM-DD` 形式で指定する日付の範囲です。
`category`	`str`	レビューのカテゴリで絞り込みます。
`rating_filters`	`list[int]`	これらの星評価 e.g のみを対象にします。`[1, 2]`。

Python

# 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 フィールドから取得します。

Python

client.reviews.details(interaction_ids: list[str]) -> APIObject

Python

details = client.reviews.details(["uuid-1", "uuid-2"])print(details.to_dict())

`reviews.respond`

レビューへの返信を投稿します。

Python

client.reviews.respond(interaction_id: str, content: str) -> APIObject

Python

result = client.reviews.respond(  interaction_id="review-uuid",  content="Thank you for your feedback, we really appreciate it!",)print(result.to_dict())

`reviews.edit_response`

既存の返信を編集します。

Python

client.reviews.edit_response(    review_id: str,    response_id: str,    content: str,) -> APIObject

Python

client.reviews.edit_response(  review_id="review-uuid",  response_id="response-uuid",  content="Updated reply text.",)

`reviews.archive_response`

返信をアーカイブ（非表示に）します。

Python

client.reviews.archive_response(response_id: str) -> APIObject

Python

client.reviews.archive_response("response-uuid")

`reviews.settings`

拠点のレビュー取得元の設定を取得します。

Python

client.reviews.settings(location_id: str | int) -> APIObject

Python

settings = client.reviews.settings(16808)print(settings.to_dict())

`reviews.edit_settings`

拠点のレビュー取得元 URL を更新します。各エントリは、1 つのレビューページを記述する dict です。

Python

client.reviews.edit_settings(    location_id: str | int,    site_urls: list[dict],) -> APIObject

Python

client.reviews.edit_settings(16808, site_urls=[  {"url": "https://www.google.com/maps/...", "active": True},])

`reviews.site_config`

アカウントで利用可能なレビューサイトを取得します。

Python

client.reviews.site_config() -> list[APIObject]

Python

sites = client.reviews.site_config()for site in sites:  print(site.to_dict())

`reviews.phrases`

レビューから抽出された、よく使われるフレーズを取得します。base64 の拠点 ID を渡します。

Python

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]

Python

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`

レビュー全体の統計（総数、平均評価、返信率）を取得します。

Python

client.reviews.analytics.overview(    location_id: str | int,    *,    start_date: str | None = None,    end_date: str | None = None,) -> APIObject

Python

stats = client.reviews.analytics.overview(  16808,  start_date="2026-01-01",  end_date="2026-06-30",)print(stats.to_dict())

`reviews.analytics.timeline`

レビューの時系列分析データを取得します。

Python

client.reviews.analytics.timeline(    location_id: str | int,    *,    start_date: str | None = None,    end_date: str | None = None,) -> APIObject

Python

timeline = 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）のレビュー分析データを取得します。

Python

client.reviews.analytics.sites_stats(    location_id: str | int,    *,    start_date: str | None = None,    end_date: str | None = None,) -> APIObject

Python

sites = client.reviews.analytics.sites_stats(  16808,  start_date="2026-01-01",  end_date="2026-06-30",)print(sites.to_dict())