Ottieni la serie temporale delle analisi delle recensioni

Parametri

Percorso

Nome	Tipo	Obbligatorio	Descrizione
locationId	string	obbligatorio	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

Query

Nome	Tipo	Obbligatorio	Descrizione	Predefinito
startDate	string	facoltativo	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	facoltativo	Last day of the series (`YYYY-MM-DD`).	—
site	string	facoltativo	Restrict the series to a single review source, by site URL (e.g. `maps.google.com`). Omit for all sources combined.	—

Risposte

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

Restituisce la serie giornaliera delle recensioni alla base di un grafico di andamento: quante recensioni sono arrivate in ciascuna data e la valutazione media in stelle di quelle recensioni. È la controparte temporale di Ottieni le analisi delle interazioni (KPI complessivi) e Ottieni le analisi delle recensioni per sito (suddivisione per fonte).

Ogni voce contiene tre campi:

date: il giorno di calendario, nel formato YYYY-MM-DD.
interactionCount: le recensioni ricevute quel giorno.
averageRating: la valutazione media in stelle delle recensioni di quel giorno, null nei giorni senza recensioni. È la media giornaliera, non una media progressiva, quindi una singola recensione da 1 stella in una giornata con poca attività viene visualizzata come 1.0 anche per un negozio con valutazioni positive.

Caso d'uso: un minigrafico di 30 giorni

Per tracciare l'andamento di 30 giorni sotto la valutazione media in stelle di una sede, chiama questo endpoint con startDate e endDate che coprono l'intervallo e rappresenta interactionCount con barre e averageRating con una linea. Abbinalo all'endpoint di riepilogo per ottenere i valori principali; i campi delta del riepilogo includono già il confronto con il periodo equivalente precedente, quindi non devi recuperare autonomamente due intervalli.

Passa site per suddividere la serie per fonte, ad esempio per mostrare che un calo della valutazione proviene da una sola piattaforma anziché da tutte. Il valore è l'URL del sito così come appare in siteSettings[].name restituito da Elenca le fonti delle recensioni per una sede.

La risposta riportata sopra è un esempio.