Acesse e modifique um gráfico da fonte de dados em uso.
Use essa classe apenas com os dados que estão conectados a um banco de dados.
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
forceRefreshData() | DataSourceChart | Atualiza os dados deste objeto, independentemente do estado atual. |
getDataSource() | DataSource | Acessa a fonte de dados vinculada ao objeto. |
getStatus() | DataExecutionStatus | Acessa o status de execução de dados do objeto. |
refreshData() | DataSourceChart | Atualiza os dados do objeto. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Aguarda até que a execução atual seja concluída, expirando após o número de segundos informado. |
Documentação detalhada
forceRefreshData()
Atualiza os dados deste objeto, independentemente do estado atual. Consulte refreshData()
para
ver mais detalhes.
Uma exceção vai ser gerada se o tipo de fonte de dados não estiver ativado. Use métodos SpreadsheetApp#enable...Execution()
para ativar a execução de dados para um tipo específico de fonte de dados.
Retornar
DataSourceChart
: o objeto de dados.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSource()
Acessa a fonte de dados vinculada ao objeto.
Retornar
DataSource
: a fonte de dados.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getStatus()
Acessa o status de execução de dados do objeto.
Retornar
DataExecutionStatus
: o status da execução de dados.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshData()
Atualiza os dados do objeto.
Lança uma exceção se estiver no estado error
. Use DataSource#updateSpec()
para atualizar a especificação. O método tem preferência sobre forceRefreshData()
para evitar edições inesperadas na fonte de dados.
Uma exceção vai ser gerada se o tipo de fonte de dados não estiver ativado. Use métodos SpreadsheetApp#enable...Execution()
para ativar a execução de dados para um tipo específico de fonte de dados.
Retornar
DataSourceChart
: o objeto de dados.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
Aguarda até que a execução atual seja concluída, expirando após o número de segundos informado. Emite uma exceção se a execução não é concluída ao expirar, mas não cancela a execução de dados.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
timeoutInSeconds | Integer | Tempo de espera da execução de dados, em segundos. O máximo é de 300 segundos. |
Retornar
DataExecutionStatus
: o status da execução de dados.
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets