レビュー分析のタイムラインを取得

パラメーター

パス

名前	型	必須	説明
locationId	string	必須	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

クエリ

名前	型	必須	説明	デフォルト
startDate	string	任意	First day of the series (`YYYY-MM-DD`). Omitting it lets the service pick its default window, so pass it whenever the chart's range matters.	—
endDate	string	任意	Last day of the series (`YYYY-MM-DD`).	—
site	string	任意	Restrict the series to a single review source, by site URL (e.g. `maps.google.com`). Omit for all sources combined.	—

レスポンス

200One entry per day in the requested range. Response key `interactionsChartData`.

Response

{  "data": {    "interactionsChartData": {      "data": [        { "date": "2026-08-01", "interactionCount": 4, "averageRating": 4.5 },        { "date": "2026-08-02", "interactionCount": 0, "averageRating": null },        { "date": "2026-08-03", "interactionCount": 7, "averageRating": 4.285714285714286 }      ]    }  }}

401Unauthenticated, missing or invalid API key.

403The key is valid but not permitted to read this location (`SY90003`).

トレンドチャートの基になる日別のレビュー時系列データとして、各日に届いたレビュー数と、それらのレビューの平均星評価を返します。このエンドポイントは、インタラクション分析を取得（全体のKPI）およびサイト別のレビュー分析を取得（ソース別の内訳）に対応するタイムライン用のエンドポイントです。

各エントリには3つのフィールドが含まれます。

date: YYYY-MM-DD形式の暦日です。
interactionCount: その日に受信したレビュー数です。
averageRating: その日のレビューの平均星評価です。レビューがない日はnullです。これは累積平均ではなく日ごとの平均なので、高評価の店舗でも、レビューが少ない日に星1つのレビューが1件だけ届いた場合は1.0と表示されます。

ユースケース：30日間のスパークライン

拠点の平均星評価の下に30日間のトレンドを描画するには、startDateとendDateでその期間を指定してこのルートを呼び出し、interactionCountを棒グラフ、averageRatingを折れ線グラフとしてプロットします。主要な数値を表示するには概要ルートと組み合わせます。概要のdeltaフィールドには、すでに直前の同じ長さの期間との比較が含まれているため、自分で2つの期間のデータを取得する必要はありません。

時系列をソース別に分割するには、siteを渡します。たとえば、評価の低下が全体的なものではなく、1つのプラットフォームに起因することを示せます。この値には、拠点のレビューソース一覧を取得のsiteSettings[].nameに表示されるサイトURLを指定します。

上記のレスポンスは一例です。