JSON/CSV/XML

Il connettore JSON/CSV/XML è diverso da tutti gli altri: non si collega a una piattaforma specifica, ma porta nel foglio i dati di qualsiasi URL tu fornisca, in formato JSON, CSV, TSV, XML o testo semplice.

Nessuna autenticazione OAuth verso terzi: la connessione verifica solo il tuo login Google per identificarti su Magic Reports, ma non conserva alcuna credenziale reale verso il sito/servizio esterno. Se l'endpoint che vuoi interrogare richiede autenticazione (API key, Bearer token, ecc.), devi fornirla tu stesso, incollandola direttamente nel campo Headers HTTP o nell'URL.

Campi di configurazione del report:

• Type URL: l'indirizzo da interrogare (es. https://miosito.it/sitemap.xml).
• Data type: il formato della risposta: JSON, CSV, TSV, XML o Testo semplice.
• Post string (opzionale): se compilato, la richiesta diventa POST con questo contenuto come corpo; se vuoto, la richiesta è GET.
• HTTP headers (opzionale): un oggetto JSON con gli header personalizzati da inviare, es. {"Authorization":"Bearer xxxxxxxx"}.
• JSONPath (opzionale): il percorso o il tag da cui estrarre i dati quando sono annidati, ad esempio "products" per un feed ecommerce, oppure il nome del tag ripetuto in un XML (es. "url" per una sitemap, "item" per un feed RSS).

Metriche disponibili

Questo connettore non ha un elenco fisso di metriche: le colonne del report vengono generate automaticamente dalla struttura della risposta del tuo URL. Ogni campo del dato ricevuto diventa una colonna; i campi annidati vengono \"appiattiti\" con la notazione a punti (es. user.name), e gli elenchi (array) vengono espansi in sotto-colonne numerate.

Dimensioni disponibili

Non esiste una distinzione tra metriche e dimensioni come negli altri connettori: tutti i campi diventano colonne del foglio (vedi Metriche disponibili qui sopra). Il campo JSONPath nella configurazione del report determina quale elenco di elementi diventa una riga (es. ogni prodotto, ogni pagina di una sitemap, ogni articolo di un feed).

Limiti noti

• Il placeholder {token} nelle Headers HTTP non è una credenziale reale
  Puoi scrivere <code>{token}</code> in un valore di header e verrà sostituito da un valore associato alla tua connessione, ma questo connettore non conserva nessuna vera API key o token esterno (la connessione serve solo a verificare il tuo login Google). Se l'endpoint richiede un'autenticazione reale, scrivi la credenziale per intero direttamente nel campo Headers HTTP o nell'URL, senza usare {token}.
• Nessuna paginazione automatica
  Ogni report esegue una sola chiamata HTTP all'URL indicato: se la tua fonte dati pagina i risultati (es. restituisce solo i primi 100 elementi con un link "next page"), il connettore scarica solo quella prima risposta, non l'intero set di dati.
• Le colonne del report non sono fisse
  Poiché le intestazioni delle colonne derivano direttamente dalla struttura della risposta della tua fonte dati, se quest'ultima cambia forma (nomi di campo, annidamento) tra un'esecuzione e l'altra, anche le colonne del foglio possono cambiare.