Class DataSourceChart

DataSourceChart

Accedi e modifica un grafico dell'origine dati esistente.

Utilizza questa classe solo con i dati connessi a un database BigQuery.

Metodi

MetodoTipo restituitoBreve descrizione
cancelDataRefresh()DataSourceChartAnnulla l'aggiornamento dei dati associato a questo oggetto, se è in esecuzione.
forceRefreshData()DataSourceChartAggiorna i dati di questo oggetto indipendentemente dallo stato attuale.
getDataSource()DataSourceRecupera l'origine dati a cui è collegato l'oggetto.
getStatus()DataExecutionStatusRecupera lo stato di esecuzione dei dati dell'oggetto.
refreshData()DataSourceChartAggiorna i dati dell'oggetto.
waitForCompletion(timeoutInSeconds)DataExecutionStatusAttende il completamento dell'esecuzione corrente, con un timeout dopo il numero di secondi fornito.

Documentazione dettagliata

cancelDataRefresh()

Annulla l'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();

Genera un'eccezione se il tipo di origine dati non è abilitato. Utilizza i metodi SpreadsheetApp#enable...Execution() per abilitare l'esecuzione dei dati per un tipo di origine dati specifico.

Indietro

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 attuale. Per maggiori dettagli, consulta refreshData(). Se vuoi annullare un aggiornamento in esecuzione di questo oggetto, consulta cancelDataRefresh().

Genera un'eccezione se il tipo di origine dati non è abilitato. Utilizza i metodi SpreadsheetApp#enable...Execution() per abilitare l'esecuzione dei dati per un tipo di origine dati specifico.

Indietro

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.

Indietro

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.

Indietro

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 si trova nello stato error. Utilizza DataSource#updateSpec() per aggiornare la specifica. Il metodo è preferibile a forceRefreshData() per evitare modifiche impreviste all'origine dati.

Genera un'eccezione se il tipo di origine dati non è abilitato. Utilizza i metodi SpreadsheetApp#enable...Execution() per abilitare l'esecuzione dei dati per un tipo di origine dati specifico.

Indietro

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, con un timeout dopo il numero di secondi fornito. Genera un'eccezione se l'esecuzione non viene completata al momento del timeout, ma non annulla l'esecuzione dei dati.

Parametri

NomeTipoDescrizione
timeoutInSecondsIntegerIl tempo di attesa per l'esecuzione dei dati, in secondi. Il valore massimo è 300 secondi.

Indietro

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