Ta strona została przetłumaczona przez Cloud Translation API.

Class DataSourceSheet

Otwierać i modyfikować istniejące arkusze źródeł danych. Aby utworzyć nowy arkusz źródła danych, użyj Spreadsheet.insertDataSourceSheet(spec).

tej klasy używaj tylko z danymi połączonymi z bazą danych.

Metody

Metoda	Zwracany typ	Krótki opis
`addFilter(columnName, filterCriteria)`	`DataSourceSheet`	Dodaje filtr zastosowany do arkusza źródeł danych.
`asSheet()`	`Sheet`	Zwraca arkusz źródła danych jako obiekt zwykłego arkusza.
`autoResizeColumn(columnName)`	`DataSourceSheet`	Automatycznie zmienia szerokość określonej kolumny.
`autoResizeColumns(columnNames)`	`DataSourceSheet`	Automatycznie zmienia szerokość określonych kolumn.
`forceRefreshData()`	`DataSourceSheet`	Odświeża dane tego obiektu niezależnie od bieżącego stanu.
`getColumnWidth(columnName)`	`Integer`	Zwraca szerokość określonej kolumny.
`getDataSource()`	`DataSource`	Pobiera źródło danych, z którym obiekt jest połączony.
`getFilters()`	`DataSourceSheetFilter[]`	Zwraca wszystkie filtry zastosowane do arkusza źródła danych.
`getSheetValues(columnName)`	`Object[]`	Zwraca wszystkie wartości dla arkusza źródła danych dla podanej nazwy kolumny.
`getSheetValues(columnName, startRow, numRows)`	`Object[]`	Zwraca wszystkie wartości dla arkusza źródła danych dla podanej nazwy kolumny z podanego wiersza początkowego (na podstawie 1) i dla podanego `numRows`.
`getSortSpecs()`	`SortSpec[]`	Pobiera wszystkie specyfikacje sortowania w arkuszu źródła danych.
`getStatus()`	`DataExecutionStatus`	Pobiera stan wykonania danych obiektu.
`refreshData()`	`DataSourceSheet`	Odświeża dane obiektu.
`removeFilters(columnName)`	`DataSourceSheet`	Usuwa wszystkie filtry zastosowane do kolumny arkusza źródła danych.
`removeSortSpec(columnName)`	`DataSourceSheet`	Usuwa kolumnę sortowania w kolumnie w arkuszu źródła danych.
`setColumnWidth(columnName, width)`	`DataSourceSheet`	Ustawia szerokość określonej kolumny.
`setColumnWidths(columnNames, width)`	`DataSourceSheet`	Ustawia szerokość określonych kolumn.
`setSortSpec(columnName, ascending)`	`DataSourceSheet`	Ustawia specyfikację sortowania w kolumnie w arkuszu źródła danych.
`setSortSpec(columnName, sortOrder)`	`DataSourceSheet`	Ustawia specyfikację sortowania w kolumnie w arkuszu źródła danych.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	Powoduje, że bieżące wykonanie zostanie zakończone po upływie określonej liczby sekund.

Szczegółowa dokumentacja

`addFilter(columnName, filterCriteria)`

Dodaje filtr zastosowany do arkusza źródeł danych.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny, do której chcesz zastosować ten filtr.
`filterCriteria`	`FilterCriteria`	Kryteria filtrowania, które mają zostać zastosowane.

Zwróć

DataSourceSheet – arkusz źródeł danych używany w łańcuchach metod.

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

`asSheet()`

Zwraca arkusz źródła danych jako obiekt zwykłego arkusza.

Zwróć

Sheet – arkusz zwykły.

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

`autoResizeColumn(columnName)`

Automatycznie zmienia szerokość określonej kolumny.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny.

Zwróć

DataSourceSheet – ten arkusz źródeł danych na potrzeby łańcucha.

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

`autoResizeColumns(columnNames)`

Automatycznie zmienia szerokość określonych kolumn.

Parametry

Nazwa	Typ	Opis
`columnNames`	`String[]`	Lista nazw kolumn do zaktualizowania.

Zwróć

DataSourceSheet – ten arkusz źródeł danych na potrzeby łańcucha.

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

`forceRefreshData()`

Odświeża dane tego obiektu niezależnie od bieżącego stanu. Więcej informacji: refreshData().

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 dla określonego typu źródła danych.

Zwróć

DataSourceSheet – obiekt 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

`getColumnWidth(columnName)`

Zwraca szerokość określonej kolumny.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny.

Zwróć

Integer – szerokość kolumny lub null, jeśli kolumna ma domyślną szerokość.

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

`getDataSource()`

Pobiera źródło danych, z którym obiekt jest połączony.

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

`getFilters()`

Zwraca wszystkie filtry zastosowane do arkusza źródła danych.

Zwróć

DataSourceSheetFilter[] – tablica wszystkich filtrów zastosowanych w arkuszu ź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

`getSheetValues(columnName)`

Zwraca wszystkie wartości dla arkusza źródła danych dla podanej nazwy kolumny.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny źródła danych, z której wartości mają zostać pobrane.

Zwróć

Object[] – jednowymiarowy tablica wartości.

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

`getSheetValues(columnName, startRow, numRows)`

Zwraca wszystkie wartości dla arkusza źródła danych dla podanej nazwy kolumny z podanego wiersza początkowego (na podstawie 1) i dla podanego numRows.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny źródła danych, z której wartości mają zostać pobrane.
`startRow`	`Integer`	Pozycja wiersza, z którego chcesz zacząć pobierać wartości.
`numRows`	`Integer`	Liczba wierszy do pobrania.

Zwróć

Object[] – jednowymiarowy tablica wartości.

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

`getSortSpecs()`

Pobiera wszystkie specyfikacje sortowania w arkuszu źródła danych.

Zwróć

SortSpec[] – lista specyfikacji sortowania.

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

`getStatus()`

Pobiera stan wykonania danych obiektu.

Zwróć

DataExecutionStatus – stan wykonania 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

`refreshData()`

Odświeża dane obiektu.

Zwraca wyjątek, jeśli obecnie jest w stanie error. Użyj DataSource#updateSpec(), aby zaktualizować specyfikację. Ta metoda jest preferowana zamiast forceRefreshData(), aby zapobiec nieoczekiwanym zmianom w źródle 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 dla określonego typu źródła danych.

Zwróć

DataSourceSheet – obiekt 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

`removeFilters(columnName)`

Usuwa wszystkie filtry zastosowane do kolumny arkusza źródła danych.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny, z której chcesz usunąć filtry.

Zwróć

DataSourceSheet – arkusz źródeł danych używany w łańcuchach metod.

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

`removeSortSpec(columnName)`

Usuwa kolumnę sortowania w kolumnie w arkuszu źródła danych.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny.

Zwróć

DataSourceSheet – arkusz źródeł danych na potrzeby łańcucha.

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

`setColumnWidth(columnName, width)`

Ustawia szerokość określonej kolumny.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny.
`width`	`Integer`	Nowa szerokość kolumny.

Zwróć

DataSourceSheet – ten arkusz źródeł danych na potrzeby łańcucha.

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

`setColumnWidths(columnNames, width)`

Ustawia szerokość określonych kolumn.

Parametry

Nazwa	Typ	Opis
`columnNames`	`String[]`	Lista nazw kolumn do zaktualizowania.
`width`	`Integer`	Nowa szerokość kolumn.

Zwróć

DataSourceSheet – ten arkusz źródeł danych na potrzeby łańcucha.

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

`setSortSpec(columnName, ascending)`

Ustawia specyfikację sortowania w kolumnie w arkuszu źródła danych.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny, którą chcesz posortować.
`ascending`	`Boolean`	Jeśli `true`, sortuj kolumnę w kolejności malejącej. Jeśli `false` ma być posortowana w kolejności malejącej.

Zwróć

DataSourceSheet – arkusz źródeł danych na potrzeby łańcucha.

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

`setSortSpec(columnName, sortOrder)`

Ustawia specyfikację sortowania w kolumnie w arkuszu źródła danych.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny, którą chcesz posortować.
`sortOrder`	`SortOrder`	Kolejność sortowania.

Zwróć

DataSourceSheet – arkusz źródeł danych na potrzeby łańcucha.

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

`waitForCompletion(timeoutInSeconds)`

Powoduje, że bieżące wykonanie zostanie zakończone po upływie określonej liczby sekund. Zwraca wyjątek, jeśli wykonanie zadania nie zostanie zakończone, ale nie anuluje jego wykonania.

Parametry

Nazwa	Typ	Opis
`timeoutInSeconds`	`Integer`	Czas oczekiwania na wykonanie danych (w sekundach). Maksymalna długość to 300 sekund.

Zwróć

DataExecutionStatus – stan wykonania 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