Dapatkan linimasa analitik ulasan

Parameter

Path

Nama	Tipe	Wajib	Deskripsi
locationId	string	wajib	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

Query

Nama	Tipe	Wajib	Deskripsi	Default
startDate	string	opsional	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	opsional	Last day of the series (`YYYY-MM-DD`).	—
site	string	opsional	Restrict the series to a single review source, by site URL (e.g. `maps.google.com`). Omit for all sources combined.	—

Respons

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`).

Mengembalikan deret ulasan per hari yang mendasari grafik tren: jumlah ulasan yang diterima pada setiap tanggal dan rata-rata nilai bintang dari ulasan tersebut. Ini adalah versi linimasa yang melengkapi Dapatkan analitik interaksi (KPI keseluruhan) dan Dapatkan analitik ulasan berdasarkan situs (perincian per sumber).

Setiap entri memuat tiga field:

date: tanggal kalender, dalam format YYYY-MM-DD.
interactionCount: ulasan yang diterima pada hari tersebut.
averageRating: rata-rata nilai bintang dari ulasan pada hari tersebut, bernilai null pada hari tanpa ulasan. Nilai ini adalah rata-rata harian, bukan rata-rata kumulatif, sehingga satu ulasan berbintang 1 pada hari yang sepi ditampilkan sebagai 1.0 bahkan untuk toko dengan nilai yang baik.

Kasus penggunaan: grafik mini 30 hari

Untuk menggambar tren 30 hari di bawah rata-rata nilai bintang suatu lokasi, panggil rute ini dengan startDate dan endDate yang mencakup rentang waktu tersebut, lalu gambarkan interactionCount sebagai batang dan averageRating sebagai garis. Gunakan bersama rute ringkasan untuk mendapatkan angka-angka utama; field delta dalam ringkasan sudah memuat perbandingan dengan periode sebelumnya yang berdurasi sama, sehingga Anda tidak perlu mengambil data untuk dua rentang waktu sendiri.

Sertakan site untuk memisahkan deret berdasarkan sumber, misalnya untuk menunjukkan bahwa penurunan nilai berasal dari satu platform, bukan dari semua platform. Nilainya adalah URL situs sebagaimana tercantum dalam siteSettings[].name dari Cantumkan sumber ulasan untuk suatu lokasi.

Respons di atas adalah contoh.