Errori comuni

I messaggi di errore più frequenti che puoi incontrare, cosa significano e come risolverli.

Questi sono gli errori più frequenti segnalati da Google Apps Script durante l'esecuzione dei report, con la causa reale e come risolverli. Sono per lo più limiti della piattaforma Google Apps Script (che ospita Magic Reports), non bug del connettore: capitano a chiunque usi add-on di questo tipo su Google Sheets.

Messaggio	Causa e soluzione
Il documento non è stato trovato o non hai accesso	Il foglio Google Sheets collegato al report è stato cancellato, spostato nel cestino, oppure l'account che esegue il report (a mano o tramite pianificazione) non ha più accesso ad esso: i permessi sono cambiati, il file è stato condiviso solo con un altro account, oppure la proprietà del file è passata ad altri. Verifica che il foglio esista ancora e che l'account collegato a Magic Reports abbia effettivamente accesso in modifica.
Tempo massimo di esecuzione superato	Google Apps Script interrompe qualunque esecuzione dopo 6 minuti: un limite della piattaforma, non modificabile. Succede con "Run reports" quando ci sono troppi report nello stesso foglio o alcuni impiegano molto tempo. Vedi la pagina Best practice per come organizzare i report per evitarlo.
Errore di memoria esaurita	Il report (o l'insieme dei report eseguiti nella stessa esecuzione) sta elaborando più dati di quanti Google Apps Script riesca a gestire in memoria in una volta sola: periodi molto lunghi, troppe righe o troppi report pesanti insieme. Riduci il periodo richiesto o dividi i report più pesanti in fogli Google Sheets separati.
Errore interno del motore JavaScript (codice DEADLINE_EXCEEDED o INTERNAL)	Un errore generico e temporaneo dei server di Google Apps Script, spesso legato a un sovraccarico momentaneo durante esecuzioni lunghe o pesanti. Nella maggior parte dei casi basta rieseguire il report: se si ripete spesso, applica gli stessi accorgimenti del tempo di esecuzione/memoria superati (periodi più corti, meno report insieme).
"Non hai accesso a questo componente aggiuntivo, contatta l'amministratore della tua organizzazione"	Non è un problema di Magic Reports: l'amministratore Google Workspace della tua organizzazione ha impostato restrizioni che bloccano l'installazione o l'uso di componenti aggiuntivi non verificati esplicitamente da lui. Contatta il tuo amministratore IT e chiedi di autorizzare Magic Reports.
Superato il limite di 10.000.000 di celle nel foglio	È un limite di Google Sheets stesso (non di Magic Reports, non modificabile): l'intero file ha raggiunto il numero massimo di celle consentite, contando tutti i fogli al suo interno. Elimina fogli o colonne non più necessari nel file, oppure sposta alcuni dei tuoi report in un nuovo foglio Google Sheets separato.
Troppi script in esecuzione simultanea per questo account Google	Il tuo account Google ha raggiunto il numero massimo di esecuzioni Apps Script in corso nello stesso momento, contando anche altri add-on installati, non solo Magic Reports. Se hai più report pianificati con "Schedule reports" tutti allo stesso orario, prova a distribuirli su fasce orarie diverse.
Permessi insufficienti sulla proprietà Google Analytics richiesta	L'account Google collegato alla connessione non ha (più) accesso in lettura a quella specifica proprietà GA4: è stato rimosso, i permessi sono cambiati, o la proprietà stessa non esiste più. Verifica l'accesso alla proprietà direttamente in Google Analytics con l'account usato per la connessione, oppure ricrea la connessione con un account che ce l'ha.
Autorizzazione del componente aggiuntivo incompleta o revocata	Errori come "non hai il permesso di chiamare SpreadsheetApp.getActiveSpreadsheet/Ui.showSidebar/Ui.showModalDialog" indicano che il flusso di autorizzazione di Magic Reports non è stato completato fino in fondo, oppure è stato revocato in un secondo momento (ad esempio da Account Google > Sicurezza > App di terze parti, o da un reset dei permessi lato amministratore Workspace). Rimuovi il componente aggiuntivo da Estensioni > Componenti aggiuntivi > Gestisci componenti aggiuntivi e reinstallalo, così da ripetere da zero la richiesta di autorizzazione.
Errore imprevisto durante l'apertura della sidebar o la modifica di un report esistente ("Cannot read properties of null")	Succede quando il foglio "Magic Reports Configuration" è stato rinominato o cancellato: Magic Reports lo cerca per nome esatto per poter leggere/scrivere i report, e se non lo trova più l'operazione fallisce con questo errore. Non rinominare né cancellare il foglio "Magic Reports Configuration": se lo hai già fatto per errore, rinominalo di nuovo esattamente così.
Si è verificato un errore del server, riprova più tardi	Un errore temporaneo lato infrastruttura Google (non specifico di Magic Reports). Nella grande maggioranza dei casi basta riprovare dopo qualche minuto.