uzyskiwać dostęp do istniejącego źródła danych i je modyfikować; Aby utworzyć tabelę źródła danych z nowym źródłem danych, przeczytaj DataSourceTable
.
Używaj tej klasy tylko z danymi połączonymi z bazą danych.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
createCalculatedColumn(name, formula) | DataSourceColumn | Tworzy obliczoną kolumnę. |
createDataSourcePivotTableOnNewSheet() | DataSourcePivotTable | Tworzy tabelę przestawną źródła danych na podstawie tego źródła danych w pierwszej komórce nowego arkusza. |
createDataSourceTableOnNewSheet() | DataSourceTable | Tworzy tabelę źródła danych na podstawie tego źródła danych w pierwszej komórce nowego arkusza. |
getCalculatedColumnByName(columnName) | DataSourceColumn | Zwraca obliczoną kolumnę w źródle danych, która jest zgodna z nazwą kolumny. |
getCalculatedColumns() | DataSourceColumn[] | Zwraca wszystkie obliczone kolumny w źródle danych. |
getColumns() | DataSourceColumn[] | Zwraca wszystkie kolumny w źródle danych. |
getDataSourceSheets() | DataSourceSheet[] | Zwraca arkusze źródła danych powiązane z tym źródłem danych. |
getSpec() | DataSourceSpec | Pobiera specyfikację źródła danych. |
refreshAllLinkedDataSourceObjects() | void | Odświeża wszystkie obiekty źródła danych połączone ze źródłem danych. |
updateSpec(spec) | DataSource | Aktualizuje specyfikację źródła danych i odświeża obiekty źródła danych połączone z tym źródłem danych o nową specyfikację. |
updateSpec(spec, refreshAllLinkedObjects) | DataSource | Aktualizuje specyfikację źródła danych i odświeża połączony data
source sheets o nową specyfikację. |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | Czeka na zakończenie wszystkich bieżących wykonań obiektów połączonego źródła danych. Limit czasu wynosi po podanej liczbie sekund. |
Szczegółowa dokumentacja
createCalculatedColumn(name, formula)
Tworzy obliczoną kolumnę.
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa obliczonej kolumny. |
formula | String | Formuła obliczonej kolumny. |
Powroty
DataSourceColumn
– nowo utworzona obliczona kolumna.
Upoważnienie
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
createDataSourcePivotTableOnNewSheet()
Tworzy tabelę przestawną źródła danych na podstawie tego źródła danych w pierwszej komórce nowego arkusza. Efektem ubocznym jest ustawienie nowego arkusza w aktywny.
Powroty
DataSourcePivotTable
– nowo utworzona tabela przestawna źródła danych.
Upoważnienie
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
createDataSourceTableOnNewSheet()
Tworzy tabelę źródła danych na podstawie tego źródła danych w pierwszej komórce nowego arkusza. Efektem ubocznym jest ustawienie nowego arkusza w aktywny.
Powroty
DataSourceTable
– nowo utworzona tabela źródeł danych.
Upoważnienie
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
getCalculatedColumnByName(columnName)
Zwraca obliczoną kolumnę w źródle danych, która jest zgodna z nazwą kolumny.
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnName | String | Nazwa obliczonej kolumny do uzyskania. |
Powroty
DataSourceColumn
– obliczona kolumna pasująca do nazwy kolumny lub null
, jeśli nie ma takiej obliczonej kolumny.
Upoważnienie
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
getCalculatedColumns()
Zwraca wszystkie obliczone kolumny w źródle danych.
Powroty
DataSourceColumn[]
– tablica wszystkich obliczonych kolumn w źródle danych.
Upoważnienie
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
getColumns()
Zwraca wszystkie kolumny w źródle danych.
Powroty
DataSourceColumn[]
– tablica wszystkich DataSourceColumn
w źródle danych.
Upoważnienie
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
getDataSourceSheets()
Zwraca arkusze źródła danych powiązane z tym źródłem danych.
Powroty
DataSourceSheet[]
– tablica arkuszy źródeł danych.
Upoważnienie
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
getSpec()
Pobiera specyfikację źródła danych.
Powroty
DataSourceSpec
– specyfikacja źródła danych.
Upoważnienie
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
refreshAllLinkedDataSourceObjects()
Odświeża wszystkie obiekty źródła danych połączone ze źródłem 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 danych w przypadku określonego typu źródła danych.
Upoważnienie
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
updateSpec(spec)
Aktualizuje specyfikację źródła danych i odświeża obiekty źródła danych połączone z tym źródłem danych o nową specyfikację.
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 danych w przypadku określonego typu źródła danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
spec | DataSourceSpec | Specyfikacja źródła danych, którą należy zaktualizować. |
Powroty
DataSource
– źródło danych.
Upoważnienie
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
updateSpec(spec, refreshAllLinkedObjects)
Aktualizuje specyfikację źródła danych i odświeża połączony data
source sheets
o nową specyfikację.
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 danych w przypadku określonego typu źródła danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
spec | DataSourceSpec | Specyfikacja źródła danych, którą należy zaktualizować. |
refreshAllLinkedObjects | Boolean | Jeśli ustawiona jest wartość true , odświeża się również wszystkie obiekty źródła danych połączone z tym źródłem danych. |
Powroty
DataSource
– źródło danych.
Upoważnienie
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
waitForAllDataExecutionsCompletion(timeoutInSeconds)
Czeka na zakończenie wszystkich bieżących wykonań obiektów połączonego źródła danych. Limit czasu wynosi po podanej liczbie sekund. Zgłasza wyjątek, jeśli uruchomienia nie zostały ukończone w momencie przekroczenia limitu czasu, ale nie anuluje wykonywania operacji do danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
timeoutInSeconds | Integer | Czas oczekiwania na uruchomienia danych (w sekundach). Maksymalna długość to 300 sekund. |
Upoważnienie
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