otwierać i modyfikować istniejący wykres źródła danych,
Używaj tej klasy tylko w przypadku danych połączonych z bazą danych BigQuery.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
cancelDataRefresh() | DataSourceChart | anuluje odświeżanie danych powiązane z tym obiektem, jeśli jest obecnie uruchomione. |
forceRefreshData() | DataSourceChart | Odświeża dane tego obiektu niezależnie od jego bieżącego stanu. |
getDataSource() | DataSource | Pobiera źródło danych, z którym połączony jest obiekt. |
getStatus() | DataExecutionStatus | Pobiera stan wykonania danych obiektu. |
refreshData() | DataSourceChart | Odświeża dane obiektu. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Czekam na zakończenie bieżącego wykonania, przekracza limit czasu po podanej liczbie sekund. |
Szczegółowa dokumentacja
cancelDataRefresh()
Anuluje odświeżanie danych powiązane z tym obiektem, jeśli jest on uruchomiony.
Ten przykład pokazuje, jak anulować odświeżenie formuły.
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie kodu dla określonego źródła danych
typu.
Powrót
DataSourceChart
– obiekt danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
Odświeża dane tego obiektu niezależnie od bieżącego stanu. Zobacz refreshData()
:
. Jeśli chcesz anulować aktualnie uruchomione odświeżanie tego obiektu, zobacz cancelDataRefresh()
.
Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie kodu dla określonego źródła danych
typu.
Powrót
DataSourceChart
– obiekt danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSource()
Pobiera źródło danych, z którym połączony jest obiekt.
Powrót
DataSource
– źródło danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getStatus()
Pobiera stan wykonania danych obiektu.
Powrót
DataExecutionStatus
– stan wykonania kodu.
Autoryzacja
Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshData()
Odświeża dane obiektu.
Wyjątek jest rzucany, jeśli aktualny stan to error
. Aby zaktualizować specyfikację, użyj polecenia DataSource#updateSpec()
. Metoda
preferowana niż forceRefreshData()
, aby zapobiec nieoczekiwanym edytowaniu źródła danych.
Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie kodu dla określonego źródła danych
typu.
Powrót
DataSourceChart
– obiekt danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
Czekam na zakończenie bieżącego wykonania, przekracza limit czasu po podanej liczbie sekund. Wyjątek jest zwracany, jeśli wykonanie nie zostało ukończone, gdy upłynął limit czasu, ale nie anuluje wykonania danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
timeoutInSeconds | Integer | Czas oczekiwania na wykonanie bazy danych (w sekundach). Maksymalna liczba to 300 sek. |
Powrót
DataExecutionStatus
– stan wykonania kodu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets