Yorum analitiği zaman çizelgesini alın

Parametreler

Yol

Ad	Tür	Zorunlu	Açıklama
locationId	string	zorunlu	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

Sorgu

Ad	Tür	Zorunlu	Açıklama	Varsayılan
startDate	string	isteğe bağlı	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	isteğe bağlı	Last day of the series (`YYYY-MM-DD`).	—
site	string	isteğe bağlı	Restrict the series to a single review source, by site URL (e.g. `maps.google.com`). Omit for all sources combined.	—

Yanıtlar

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

Bir eğilim grafiğinin temelini oluşturan günlük yorum serisini döndürür: her tarihte kaç yorum geldiğini ve bu yorumların ortalama yıldız puanını gösterir. Etkileşim analitiğini alın (genel KPI'lar) ve Siteye göre yorum analitiğini alın (kaynak bazında döküm) işlemlerinin zaman çizelgesi karşılığıdır.

Her kayıt üç alan içerir:

date: YYYY-MM-DD biçiminde takvim günü.
interactionCount: o gün alınan yorum sayısı.
averageRating: o günkü yorumların ortalama yıldız puanı; yorum olmayan bir günde null. Bu, kümülatif değil, günlük ortalamadır; dolayısıyla az yorum gelen bir günde alınan tek bir 1 yıldızlı yorum, yüksek puanlı bir mağaza için bile 1.0 olarak görünür.

Kullanım örneği: 30 günlük mini grafik

Bir konumun yıldız ortalamasının altında 30 günlük bir eğilim çizmek için bu rotayı, söz konusu dönemi kapsayan startDate ve endDate ile çağırın ve interactionCount verilerini çubuklar, averageRating verilerini ise çizgi olarak gösterin. Temel sayısal göstergeler için bunu genel bakış rotasıyla birlikte kullanın; genel bakışın delta alanları zaten önceki eşdeğer dönemle karşılaştırma yaptığından, iki dönemin verilerini kendiniz almanız gerekmez.

Seriyi kaynağa göre ayırmak için site parametresini iletin; örneğin, bir puan düşüşünün tüm platformlarda değil, tek bir platformda gerçekleştiğini göstermek için bunu kullanabilirsiniz. Değer, Bir konumun yorum kaynaklarını listeleyin işleminden alınan siteSettings[].name içinde göründüğü şekliyle sitenin URL'sidir.

Yukarıdaki yanıt bir örnektir.