Class DataSourceChart

GraficoOriginedati

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
cancelDataRefresh()	DataSourceChart	Annullamento dell'aggiornamento dei dati associato a questo oggetto se è in esecuzione.
forceRefreshData()	DataSourceChart	Aggiorna i dati di questo oggetto indipendentemente dallo stato corrente.
getDataSource()	DataSource	Recupera l'origine dati a cui è collegato l'oggetto.
getStatus()	DataExecutionStatus	Recupera lo stato di esecuzione dei dati dell'oggetto.
refreshData()	DataSourceChart	Aggiorna i dati dell'oggetto.
waitForCompletion(timeoutInSeconds)	DataExecutionStatus	Attende il completamento dell'esecuzione corrente e termina dopo il numero di secondi specificato.

Documentazione dettagliata

cancelDataRefresh()

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 SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un tipo di origine dati specifico.

Invio

DataSourceChart: 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

---

forceRefreshData()

Aggiorna i dati di questo oggetto indipendentemente dallo stato corrente. Per maggiori dettagli, consulta refreshData(). Se vuoi annullare un aggiornamento di questo oggetto attualmente in esecuzione, consulta cancelDataRefresh().

Viene lanciata un'eccezione se il tipo di origine dati non è attivo. Utilizza i metodi SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un tipo di origine dati specifico.

Invio

DataSourceChart: 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

---

getDataSource()

Recupera l'origine dati a cui è collegato l'oggetto.

Invio

DataSource: 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

---

getStatus()

Recupera lo stato di esecuzione dei dati dell'oggetto.

Invio

DataExecutionStatus: 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

---

refreshData()

Aggiorna i dati dell'oggetto.

Genera un'eccezione se è attualmente nello stato error. Utilizza DataSource#updateSpec() per aggiornare la specifica. Il metodo è preferito a forceRefreshData() per evitare modifiche impreviste all'origine dati.

Viene lanciata un'eccezione se il tipo di origine dati non è attivo. Utilizza i metodi SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un tipo di origine dati specifico.

Invio

DataSourceChart: 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

---

waitForCompletion(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
timeoutInSeconds	Integer	Il tempo di attesa per l'esecuzione dei dati, in secondi. Il valore massimo è 300 secondi.

Invio

DataExecutionStatus: 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