API Tutorial
Come ottenere le analitiche di Google Business tramite API
Per ottenere le analitiche di Google Business tramite API, collega Google Business con Modiva e poi chiama `analytics_unified` — restituisce reach, impression, engagement e metriche sui follower in una forma normalizzata che puoi visualizzare o analizzare.
Ogni piattaforma riporta le metriche in modo diverso, quindi il reporting cross-piattaforma di solito richiede un livello di mapping per ogni rete. Lo strumento `analytics_unified` di Modiva restituisce le metriche di Google Business nello stesso schema di ogni altra piattaforma, così una singola query alimenta un'intera dashboard.
Passo dopo passo
Crea un account Modiva e una chiave MCP
Registrati gratuitamente e genera una chiave MCP (`mk_live_…`) dalla dashboard. La stessa chiave autentica sia il server MCP ospitato (per gli agenti IA) sia la REST API (per il tuo backend), così gestisci un'unica credenziale.
Collega il tuo account Google Business
Nella dashboard clicca su Collega e scegli Google Business. Modiva esegue il flusso OAuth e richiede per te gli scope corretti, poi salva i token di accesso e di refresh in un vault cifrato e li mantiene aggiornati — non maneggi mai le credenziali API grezze di Google Business. La connessione riceve un `connectionId` stabile a cui fai riferimento in ogni chiamata.
Chiama analytics_unified per le metriche di Google Business
Chiama `analytics_unified` con l'ID della connessione, le metriche che desideri e un intervallo di tempo. Modiva le recupera da Google Business, normalizza i nomi dei campi e restituisce una forma JSON coerente, pronta da visualizzare.
Unisci ogni piattaforma in un unico report
Passa più ID di connessione per combinare Google Business con il resto del tuo stack in un'unica risposta. Tramite MCP un agente può recuperare i numeri e scrivere il report settimanale per te, poi chiamare `analytics_best_time_to_post` per pianificare il prossimo.
Richiesta di esempio
Chiama lo strumento analytics_unified tramite l'API REST di Modiva. Lo stesso strumento è disponibile per gli agenti IA sul server MCP all'indirizzo https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "analytics_unified",
"connectionId": "conn_…",
"args": { "metrics": ["reach", "engagement"], "period": "last_30_days" }
}'Provalo con Google Business
Inizia gratisFAQ
Le metriche di Google Business sono confrontabili con quelle delle altre piattaforme?
Sì — Modiva normalizza le analitiche di Google Business in uno schema comune, così reach ed engagement combaciano su ogni rete collegata.
Un agente IA può generare il report?
Sì. Esponi `analytics_unified` tramite MCP e un agente può recuperare i numeri di Google Business e comporre la sintesi in autonomia.