Accedi a un grafico dell'origine dati esistente e modificalo.
Utilizza questa classe solo con dati collegati a un database BigQuery.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
cancel | Data | Annullamento dell'aggiornamento dei dati associato a questo oggetto se è in esecuzione. |
force | Data | Aggiorna i dati di questo oggetto indipendentemente dallo stato corrente. |
get | Data | Recupera l'origine dati a cui è collegato l'oggetto. |
get | Data | Recupera lo stato di esecuzione dei dati dell'oggetto. |
refresh | Data | Aggiorna i dati dell'oggetto. |
wait | Data | Attende il completamento dell'esecuzione corrente e termina dopo il numero di secondi specificato. |
Documentazione dettagliata
cancel Data Refresh()
Annullamento dell'aggiornamento dei dati associato a questo oggetto se è in esecuzione.
Questo esempio mostra come annullare l'aggiornamento di una formula.
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
Viene lanciata un'eccezione se il tipo di origine dati non è attivo. Utilizza i metodi Spreadsheet
per attivare l'esecuzione dei dati per un tipo di origine dati specifico.
Invio
Data
: l'oggetto dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
force Refresh Data()
Aggiorna i dati di questo oggetto indipendentemente dallo stato corrente. Per maggiori dettagli, consulta refresh
. Se vuoi annullare un aggiornamento di questo oggetto attualmente in esecuzione, consulta cancel
.
Viene lanciata un'eccezione se il tipo di origine dati non è attivo. Utilizza i metodi Spreadsheet
per attivare l'esecuzione dei dati per un tipo di origine dati specifico.
Invio
Data
: l'oggetto dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source()
Recupera l'origine dati a cui è collegato l'oggetto.
Invio
Data
: l'origine dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Status()
Recupera lo stato di esecuzione dei dati dell'oggetto.
Invio
Data
: lo stato di esecuzione dei dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refresh Data()
Aggiorna i dati dell'oggetto.
Genera un'eccezione se è attualmente nello stato error
. Utilizza Data
per aggiornare la specifica. Il metodo è preferito a force
per evitare modifiche impreviste all'origine dati.
Viene lanciata un'eccezione se il tipo di origine dati non è attivo. Utilizza i metodi Spreadsheet
per attivare l'esecuzione dei dati per un tipo di origine dati specifico.
Invio
Data
: l'oggetto dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
wait For Completion(timeoutInSeconds)
Attende il completamento dell'esecuzione corrente e termina dopo il numero di secondi specificato. Genera un'eccezione se l'esecuzione non è completata al termine del timeout, ma non annulla l'esecuzione dei dati.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
timeout | Integer | Il tempo di attesa per l'esecuzione dei dati, in secondi. Il valore massimo è 300 secondi. |
Invio
Data
: lo stato di esecuzione dei dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets