Uzyskaj dostęp do istniejącego źródła danych i zmodyfikuj je. Aby utworzyć tabelę źródeł danych z nowym źródłem danych, zajrzyj do DataSourceTable
.
tej klasy używaj 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 z tego źródła danych w pierwszej komórce nowego arkusza. |
createDataSourceTableOnNewSheet() | DataSourceTable | Tworzy tabelę źródeł danych z tego źródła w pierwszej komórce nowego arkusza. |
getCalculatedColumnByName(columnName) | DataSourceColumn | Zwraca obliczoną kolumnę w źródle danych, która pasuje do nazwy 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ódeł 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 data
source sheets zgodnie z nową specyfikacją. |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | Zaczekaj, aż wszystkie bieżące wykonania połączonych obiektów źródła danych zostaną zakończone i przekroczony limit czasu sekund. |
Szczegółowa dokumentacja
createCalculatedColumn(name, formula)
Tworzy obliczoną kolumnę.
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nazwa obliczonej kolumny. |
formula | String | Obliczona formuła kolumny. |
Zwróć
DataSourceColumn
– nowo obliczona kolumna,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 z tego źródła danych w pierwszej komórce nowego arkusza. Efektem ubocznym jest to, że nowy arkusz stanie się aktywny.
Zwróć
DataSourcePivotTable
– nowo utworzona tabela przestawna źródła danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourceTableOnNewSheet()
Tworzy tabelę źródeł danych z tego źródła w pierwszej komórce nowego arkusza. Jako efekt uboczny powoduje, że nowy arkusz jest aktywny.
Zwróć
DataSourceTable
– nowo utworzona tabela źródła danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 pasuje do nazwy kolumny.
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnName | String | Nazwa obliczonej kolumny, którą chcesz pobrać. |
Zwróć
DataSourceColumn
– obliczona kolumna odpowiada nazwie kolumny lub null
, jeśli nie ma takiej obliczonej kolumny.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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.
Zwróć
DataSourceColumn[]
– tablica wszystkich obliczonych kolumn w źródle danych
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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.
Zwróć
DataSourceColumn[]
– tablica wszystkich wartości DataSourceColumn
w źródle danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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.
Zwróć
DataSourceSheet[]
– tablica arkuszy źródeł danych
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSpec()
Pobiera specyfikację źródła danych.
Zwróć
DataSourceSpec
– specyfikacja źródła danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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.
Zwraca wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie danych do określonego typu źródła danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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ódeł danych połączone z tym źródłem danych o nową specyfikację.
Zwraca wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie danych do określonego typu źródła danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
spec | DataSourceSpec | Specyfikacja źródła danych, którą chcesz zaktualizować. |
Zwróć
DataSource
– źródło danych,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 data
source sheets
zgodnie z nową specyfikacją.
Zwraca wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie danych do określonego typu źródła danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
spec | DataSourceSpec | Specyfikacja źródła danych, którą chcesz zaktualizować. |
refreshAllLinkedObjects | Boolean | Jeśli true , odświeży też wszystkie obiekty źródła danych połączone z tym źródłem danych. |
Zwróć
DataSource
– źródło danych,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForAllDataExecutionsCompletion(timeoutInSeconds)
Zaczekaj, aż wszystkie bieżące wykonania połączonych obiektów źródła danych zostaną zakończone i przekroczony limit czasu sekund. Zwraca wyjątek, jeśli wykonania nie zostaną zakończone po przekroczeniu limitu czasu, ale nie anulują uruchomień danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
timeoutInSeconds | Integer | Czas oczekiwania na wykonanie danych (w sekundach). Maksymalna długość to 300 sekund. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets