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

Class Spreadsheet

Uzyskiwanie dostępu do plików Arkuszy Google i ich modyfikowanie. Typowe operacje to dodawanie nowych arkuszy i dodawanie współpracowników.

Metody

Metoda	Zwracany typ	Krótki opis
`addDeveloperMetadata(key)`	`Spreadsheet`	Dodaje metadane dewelopera z określonym kluczem do arkusza kalkulacyjnego najwyższego poziomu.
`addDeveloperMetadata(key, visibility)`	`Spreadsheet`	Dodaje metadane dewelopera z określonym kluczem i widocznością do arkusza kalkulacyjnego.
`addDeveloperMetadata(key, value)`	`Spreadsheet`	Dodaje do arkusza kalkulacyjnego metadane dewelopera z określonym kluczem i wartością.
`addDeveloperMetadata(key, value, visibility)`	`Spreadsheet`	Dodaje do arkusza kalkulacyjnego metadane dewelopera z określonym kluczem, wartością i widocznością.
`addEditor(emailAddress)`	`Spreadsheet`	Dodaje wybranego użytkownika do listy edytorów `Spreadsheet`.
`addEditor(user)`	`Spreadsheet`	Dodaje wybranego użytkownika do listy edytorów `Spreadsheet`.
`addEditors(emailAddresses)`	`Spreadsheet`	Dodaje określoną tablicę użytkowników do listy edytorów `Spreadsheet`.
`addMenu(name, subMenus)`	`void`	Tworzy nowe menu w interfejsie arkusza kalkulacyjnego.
`addViewer(emailAddress)`	`Spreadsheet`	Dodaje danego użytkownika do listy widzów elementu `Spreadsheet`.
`addViewer(user)`	`Spreadsheet`	Dodaje danego użytkownika do listy widzów elementu `Spreadsheet`.
`addViewers(emailAddresses)`	`Spreadsheet`	Dodaje określoną tablicę użytkowników do listy widzów elementu `Spreadsheet`.
`appendRow(rowContents)`	`Sheet`	Dołącza wiersz na dole bieżącego regionu danych w arkuszu.
`autoResizeColumn(columnPosition)`	`Sheet`	Ustawia szerokość danej kolumny, aby dopasować ją do jej zawartości.
`copy(name)`	`Spreadsheet`	Skopiuje arkusz kalkulacyjny i zwraca nowy.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Zwraca wartość `DeveloperMetadataFinder`, aby znaleźć metadane dewelopera w zakresie tego arkusza kalkulacyjnego.
`createTextFinder(findText)`	`TextFinder`	Tworzy wyszukiwarkę tekstu dla arkusza kalkulacyjnego, która służy do znajdowania i zastępowania tekstu w arkuszu kalkulacyjnym.
`deleteActiveSheet()`	`Sheet`	Usuwa aktualnie aktywny arkusz.
`deleteColumn(columnPosition)`	`Sheet`	Usuwa kolumnę na danej pozycji.
`deleteColumns(columnPosition, howMany)`	`void`	Usuwa kilka kolumn, które zaczynają się od danej pozycji.
`deleteRow(rowPosition)`	`Sheet`	Usuwa wiersz z danej pozycji.
`deleteRows(rowPosition, howMany)`	`void`	Usuwa kilka wierszy z danej pozycji.
`deleteSheet(sheet)`	`void`	Usuwa określony arkusz.
`duplicateActiveSheet()`	`Sheet`	Powoduje utworzenie duplikatu aktywnego arkusza i utworzenie z niego aktywnego arkusza.
`getActiveCell()`	`Range`	Zwraca aktywną komórkę w tym arkuszu.
`getActiveRange()`	`Range`	Zwraca wybrany zakres w aktywnym arkuszu lub `null`, jeśli nie ma aktywnego zakresu.
`getActiveRangeList()`	`RangeList`	Zwraca listę aktywnych zakresów w aktywnym arkuszu lub zmienną `null`, jeśli nie ma aktywnych zakresów.
`getActiveSheet()`	`Sheet`	Pobiera aktywny arkusz w arkuszu kalkulacyjnym.
`getAs(contentType)`	`Blob`	Zwraca dane wewnątrz tego obiektu w postaci obiektu blob przekonwertowanego na określony typ treści.
`getBandings()`	`Banding[]`	Zwraca wszystkie pasma w tym arkuszu kalkulacyjnym.
`getBlob()`	`Blob`	Zwróć dane wewnątrz tego obiektu jako obiekt blob.
`getColumnWidth(columnPosition)`	`Integer`	Pobiera szerokość pikseli w danej kolumnie.
`getCurrentCell()`	`Range`	Zwraca aktualną komórkę w aktywnym arkuszu lub atrybut `null`, jeśli nie ma bieżącej komórki.
`getDataRange()`	`Range`	Zwraca wartość `Range` odpowiadającą wymiarom, dla których są dostępne dane.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Pobiera wszystkie formuły źródła danych.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Pobiera wszystkie tabele przestawne źródeł danych.
`getDataSourceRefreshSchedules()`	`DataSourceRefreshSchedule[]`	Pobiera harmonogramy odświeżania tego arkusza kalkulacyjnego.
`getDataSourceSheets()`	`DataSourceSheet[]`	Zwraca wszystkie arkusze źródeł danych w arkuszu kalkulacyjnym.
`getDataSourceTables()`	`DataSourceTable[]`	Pobiera wszystkie tabele źródeł danych.
`getDataSources()`	`DataSource[]`	Zwraca wszystkie źródła danych w arkuszu kalkulacyjnym.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Pobierz metadane dewelopera powiązane z arkuszem kalkulacyjnym najwyższego poziomu.
`getEditors()`	`User[]`	Pobiera listę edytorów tego pliku (`Spreadsheet`).
`getFormUrl()`	`String`	Zwraca URL formularza, który wysyła odpowiedzi z tego arkusza kalkulacyjnego, lub `null`, jeśli nie ma powiązanego formularza.
`getFrozenColumns()`	`Integer`	Zwraca liczbę zablokowanych kolumn.
`getFrozenRows()`	`Integer`	Zwraca liczbę zablokowanych wierszy.
`getId()`	`String`	Pobiera unikalny identyfikator tego arkusza kalkulacyjnego.
`getImages()`	`OverGridImage[]`	Zwraca wszystkie obrazy poza siatką arkusza.
`getIterativeCalculationConvergenceThreshold()`	`Number`	Zwraca wartość progową używaną podczas obliczania iteracyjnego.
`getLastColumn()`	`Integer`	Zwraca pozycję ostatniej kolumny, która zawiera treści.
`getLastRow()`	`Integer`	Zwraca pozycję ostatniego wiersza z treścią.
`getMaxIterativeCalculationCycles()`	`Integer`	Zwraca maksymalną liczbę iteracji używanych podczas obliczania iteracyjnego.
`getName()`	`String`	Pobiera nazwę dokumentu.
`getNamedRanges()`	`NamedRange[]`	Pobiera wszystkie nazwane zakresy w tym arkuszu kalkulacyjnym.
`getNumSheets()`	`Integer`	Zwraca liczbę arkuszy w tym arkuszu kalkulacyjnym.
`getOwner()`	`User`	Zwraca właściciela dokumentu lub parametr `null` dokumentu w przypadku dysku współdzielonego.
`getPredefinedSpreadsheetThemes()`	`SpreadsheetTheme[]`	Zwraca listę wstępnie zdefiniowanych motywów.
`getProtections(type)`	`Protection[]`	Pobiera tablicę obiektów reprezentujących wszystkie chronione zakresy lub arkusze w arkuszu kalkulacyjnym.
`getRange(a1Notation)`	`Range`	Zwraca zakres określony w notacji A1 lub notacji R1C1.
`getRangeByName(name)`	`Range`	Zwraca zakres nazwany lub `null`, jeśli nie znaleziono zakresu o podanej nazwie.
`getRangeList(a1Notations)`	`RangeList`	Zwraca kolekcję `RangeList` reprezentującą zakresy w tym samym arkuszu określonym przez niepustą listę notacji A1 lub notacji R1C1.
`getRecalculationInterval()`	`RecalculationInterval`	Zwraca przedział obliczeowy tego arkusza kalkulacyjnego.
`getRowHeight(rowPosition)`	`Integer`	Pobiera wysokość w pikselach danego wiersza.
`getSelection()`	`Selection`	Zwraca aktualną wartość `Selection` w arkuszu kalkulacyjnym.
`getSheetByName(name)`	`Sheet`	Zwraca arkusz o podanej nazwie.
`getSheetId()`	`Integer`	Zwraca identyfikator arkusza reprezentowanego przez ten obiekt.
`getSheetName()`	`String`	Zwraca nazwę arkusza.
`getSheetValues(startRow, startColumn, numRows, numColumns)`	`Object[][]`	Zwraca prostokątną siatkę wartości dla tego zakresu rozpoczynającego się od podanych współrzędnych.
`getSheets()`	`Sheet[]`	Pobiera wszystkie arkusze z tego arkusza kalkulacyjnego.
`getSpreadsheetLocale()`	`String`	Pobiera język arkusza kalkulacyjnego.
`getSpreadsheetTheme()`	`SpreadsheetTheme`	Zwraca bieżący motyw arkusza kalkulacyjnego lub `null`, jeśli nie został on dodany.
`getSpreadsheetTimeZone()`	`String`	Pobiera strefę czasową arkusza kalkulacyjnego.
`getUrl()`	`String`	Zwraca adres URL określonego arkusza kalkulacyjnego.
`getViewers()`	`User[]`	Pobiera listę widzów i komentarzy do filmu `Spreadsheet`.
`hideColumn(column)`	`void`	Ukrywa kolumny lub kolumny w danym zakresie.
`hideRow(row)`	`void`	Ukrywa wiersze w danym zakresie.
`insertColumnAfter(afterPosition)`	`Sheet`	Wstawia kolumnę za określoną pozycją kolumny.
`insertColumnBefore(beforePosition)`	`Sheet`	Wstawia kolumnę przed określoną pozycją kolumny.
`insertColumnsAfter(afterPosition, howMany)`	`Sheet`	Wstawia liczbę kolumn po określonej pozycji kolumny.
`insertColumnsBefore(beforePosition, howMany)`	`Sheet`	Wstawia określoną liczbę kolumn przed daną pozycją.
`insertDataSourceSheet(spec)`	`DataSourceSheet`	Wstawienie nowego arkusza `DataSourceSheet` w arkuszu kalkulacyjnym i rozpoczęcie wykonywania danych.
`insertImage(blobSource, column, row)`	`OverGridImage`	Wstawia `Spreadsheet` jako obraz w dokumencie w danym wierszu i kolumnie.
`insertImage(blobSource, column, row, offsetX, offsetY)`	`OverGridImage`	Wstawia `Spreadsheet` jako obraz w danym dokumencie w danym wierszu i w kolumnie z przesunięciem pikseli.
`insertImage(url, column, row)`	`OverGridImage`	Wstawia obraz w dokumencie w danym wierszu i kolumnie.
`insertImage(url, column, row, offsetX, offsetY)`	`OverGridImage`	Wstawia obraz w dokumencie w danym wierszu i w kolumnie z przesunięciem piksela.
`insertRowAfter(afterPosition)`	`Sheet`	Wstawia wiersz po określonej pozycji.
`insertRowBefore(beforePosition)`	`Sheet`	Wstawia wiersz przed daną pozycją w wierszu.
`insertRowsAfter(afterPosition, howMany)`	`Sheet`	Wstawia liczbę wierszy po określonej pozycji wiersza.
`insertRowsBefore(beforePosition, howMany)`	`Sheet`	Wstawia liczbę wierszy przed daną pozycją.
`insertSheet()`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego przy użyciu domyślnej nazwy arkusza.
`insertSheet(sheetIndex)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego o określonym indeksie.
`insertSheet(sheetIndex, options)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego w przypadku określonego indeksu i używa opcjonalnych argumentów zaawansowanych.
`insertSheet(options)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego przy użyciu domyślnej nazwy arkusza i opcjonalnych argumentów zaawansowanych.
`insertSheet(sheetName)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego o podanej nazwie.
`insertSheet(sheetName, sheetIndex)`	`Sheet`	Wstawia do arkusza kalkulacyjnego nowy arkusz o danej nazwie w danym indeksie.
`insertSheet(sheetName, sheetIndex, options)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego o danej nazwie w danym indeksie i stosuje opcjonalne argumenty zaawansowane.
`insertSheet(sheetName, options)`	`Sheet`	Wstawia nowy arkusz do arkusza kalkulacyjnego o podanej nazwie i stosuje opcjonalne argumenty zaawansowane.
`insertSheetWithDataSourceTable(spec)`	`Sheet`	Wstawia nowy arkusz w arkuszu kalkulacyjnym, tworzy `DataSourceTable` obejmujący cały arkusz o danej specyfikacji źródła danych i uruchamia dane.
`isColumnHiddenByUser(columnPosition)`	`Boolean`	Zwraca wartość, która wskazuje, czy dana kolumna jest ukryta przez użytkownika.
`isIterativeCalculationEnabled()`	`Boolean`	Zwraca, czy w tym arkuszu kalkulacyjnym włączone są obliczenia iteracyjne.
`isRowHiddenByFilter(rowPosition)`	`Boolean`	Zwraca, czy dany wiersz jest ukryty przez filtr (a nie w widoku filtra).
`isRowHiddenByUser(rowPosition)`	`Boolean`	Wskazuje, czy dany wiersz jest ukryty przez użytkownika.
`moveActiveSheet(pos)`	`void`	Przenosi aktywny arkusz na określoną pozycję na liście arkuszy.
`moveChartToObjectSheet(chart)`	`Sheet`	Tworzy nowy arkusz `SheetType.OBJECT` i przenosi do niego podany wykres.
`refreshAllDataSources()`	`void`	Odświeża wszystkie obsługiwane źródła danych i powiązane z nimi obiekty źródeł danych, pomijając nieprawidłowe obiekty źródeł danych.
`removeEditor(emailAddress)`	`Spreadsheet`	Usunięcie użytkownika z listy edytorów `Spreadsheet`.
`removeEditor(user)`	`Spreadsheet`	Usunięcie użytkownika z listy edytorów `Spreadsheet`.
`removeMenu(name)`	`void`	Usuwa menu dodane przez użytkownika `addMenu(name, subMenus)`.
`removeNamedRange(name)`	`void`	Usuwa zakres nazwany o podanej nazwie.
`removeViewer(emailAddress)`	`Spreadsheet`	Usunięcie użytkownika z listy widzów i komentujących: `Spreadsheet`.
`removeViewer(user)`	`Spreadsheet`	Usunięcie użytkownika z listy widzów i komentujących: `Spreadsheet`.
`rename(newName)`	`void`	Zmienia nazwę dokumentu.
`renameActiveSheet(newName)`	`void`	Zmienia nazwę bieżącego aktywnego arkusza na nową.
`resetSpreadsheetTheme()`	`SpreadsheetTheme`	Usuwa zastosowany motyw i ustawia motyw domyślny w arkuszu kalkulacyjnym.
`setActiveRange(range)`	`Range`	Ustawia aktywny zakres jako `active range` w aktywnym arkuszu, a lewą górną komórkę w zakresie jako `current cell`.
`setActiveRangeList(rangeList)`	`RangeList`	Ustawia w aktywnym arkuszu określoną listę zakresów jako `active ranges`.
`setActiveSelection(range)`	`Range`	Określa region aktywnego wyboru w tym arkuszu.
`setActiveSelection(a1Notation)`	`Range`	Określa aktywny wybór zgodnie z zapisem A1 lub R1C1.
`setActiveSheet(sheet)`	`Sheet`	Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym.
`setActiveSheet(sheet, restoreSelection)`	`Sheet`	Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym z opcją przywrócenia najnowszego zaznaczenia w tym arkuszu.
`setColumnWidth(columnPosition, width)`	`Sheet`	Ustawia szerokość danej kolumny w pikselach.
`setCurrentCell(cell)`	`Range`	Ustawia określoną komórkę jako `current cell`.
`setFrozenColumns(columns)`	`void`	Powoduje zablokowanie podanej liczby kolumn.
`setFrozenRows(rows)`	`void`	Powoduje zablokowanie podanej liczby wierszy.
`setIterativeCalculationConvergenceThreshold(minThreshold)`	`Spreadsheet`	Ustawia minimalną wartość progową do obliczeń iteracyjnych.
`setIterativeCalculationEnabled(isEnabled)`	`Spreadsheet`	Określa, czy w tym arkuszu kalkulacyjnym włączone są obliczenia iteracyjne.
`setMaxIterativeCalculationCycles(maxIterations)`	`Spreadsheet`	Określa maksymalną liczbę iteracji obliczeń, które powinny być wykonane podczas obliczeń iteracyjnych.
`setNamedRange(name, range)`	`void`	Określa zakres.
`setRecalculationInterval(recalculationInterval)`	`Spreadsheet`	Określa, jak często ten arkusz kalkulacyjny ma być przeliczany.
`setRowHeight(rowPosition, height)`	`Sheet`	Ustawia wysokość wiersza w pikselach.
`setSpreadsheetLocale(locale)`	`void`	Ustawia język arkusza kalkulacyjnego.
`setSpreadsheetTheme(theme)`	`SpreadsheetTheme`	Ustawia motyw arkusza kalkulacyjnego.
`setSpreadsheetTimeZone(timezone)`	`void`	Ustawia strefę czasową arkusza kalkulacyjnego.
`show(userInterface)`	`void`	Wyświetla komponent interfejsu użytkownika w oknie wyśrodkowanym w widocznym obszarze przeglądarki użytkownika.
`sort(columnPosition)`	`Sheet`	Sortuje arkusz według kolumny rosnąco.
`sort(columnPosition, ascending)`	`Sheet`	Sortuje arkusz według kolumny.
`toast(msg)`	`void`	Pokazuje wyskakujące okienko w prawym dolnym rogu arkusza kalkulacyjnego z tą wiadomością.
`toast(msg, title)`	`void`	W prawym dolnym rogu arkusza kalkulacyjnego wyświetla wyskakujące okienko z określoną wiadomością i tytułem.
`toast(msg, title, timeoutSeconds)`	`void`	W prawym dolnym rogu arkusza kalkulacyjnego wyświetla wyskakujące okienko z określonym tytułem i wiadomością, które jest widoczne przez określony czas.
`unhideColumn(column)`	`void`	Odkryj kolumnę w podanym zakresie.
`unhideRow(row)`	`void`	Odkryje wiersz w podanym zakresie.
`updateMenu(name, subMenus)`	`void`	Aktualizuje menu dodane przez użytkownika `addMenu(name, subMenus)`.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	Zaczekaj, aż wszystkie bieżące wykonania arkusza kalkulacyjnego zostaną zakończone i przekroczy limit czasu po upływie określonej liczby sekund.

Metody wycofane

Metoda	Zwracany typ	Krótki opis
`getSheetProtection()`	`PageProtection`	Zwraca instancję `PageProtection` z opisem uprawnień do bieżącego arkusza.
`isAnonymousView()`	`Boolean`	Wskazuje, czy dokument umożliwia anonimowe wyświetlanie.
`isAnonymousWrite()`	`Boolean`	Wskazuje, czy dokument umożliwia edytowanie przez anonimowych użytkowników.
`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`	`void`	Ustawia zasady dokumentu dotyczące anonimowego odczytu i zapisu.
`setSheetProtection(permissions)`	`void`	Ustawia uprawnienia dla bieżącego arkusza.

Szczegółowa dokumentacja

`addDeveloperMetadata(key)`

Dodaje metadane dewelopera z określonym kluczem do arkusza kalkulacyjnego najwyższego poziomu.

Parametry

Nazwa	Typ	Opis
`key`	`String`	Klucz do nowych metadanych dewelopera.

Zwróć

Spreadsheet – ten arkusz kalkulacyjny na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają 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

`addDeveloperMetadata(key, visibility)`

Dodaje metadane dewelopera z określonym kluczem i widocznością do arkusza kalkulacyjnego.

Parametry

Nazwa	Typ	Opis
`key`	`String`	Klucz do nowych metadanych dewelopera.
`visibility`	`DeveloperMetadataVisibility`	Widoczność nowych metadanych dewelopera.

Zwróć

Spreadsheet – ten arkusz kalkulacyjny na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają 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

`addDeveloperMetadata(key, value)`

Dodaje do arkusza kalkulacyjnego metadane dewelopera z określonym kluczem i wartością.

Parametry

Nazwa	Typ	Opis
`key`	`String`	Klucz do nowych metadanych dewelopera.
`value`	`String`	Wartość nowych metadanych dewelopera.

Zwróć

Spreadsheet – ten arkusz kalkulacyjny na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają 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

`addDeveloperMetadata(key, value, visibility)`

Dodaje do arkusza kalkulacyjnego metadane dewelopera z określonym kluczem, wartością i widocznością.

Parametry

Nazwa	Typ	Opis
`key`	`String`	Klucz do nowych metadanych dewelopera.
`value`	`String`	Wartość nowych metadanych dewelopera.
`visibility`	`DeveloperMetadataVisibility`	Widoczność nowych metadanych dewelopera.

Zwróć

Spreadsheet – ten arkusz kalkulacyjny na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają 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

`addEditor(emailAddress)`

Dodaje wybranego użytkownika do listy edytorów Spreadsheet. Jeśli użytkownik był już na liście widzów, ta metoda powoduje, że zostanie on usunięty z listy widzów.

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, którego chcesz dodać.

Zwróć

Spreadsheet – to Spreadsheet do łańcucha.

Upoważnienie

Skrypty, które używają 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

`addEditor(user)`

Dodaje wybranego użytkownika do listy edytorów Spreadsheet. Jeśli użytkownik był już na liście widzów, ta metoda powoduje, że zostanie on usunięty z listy widzów.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika do dodania.

Zwróć

Spreadsheet – to Spreadsheet do łańcucha.

Upoważnienie

Skrypty, które używają 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

`addEditors(emailAddresses)`

Dodaje określoną tablicę użytkowników do listy edytorów Spreadsheet. Jeśli którykolwiek użytkownik był na liście widzów, ta metoda spowoduje, że znikną oni z listy widzów.

Parametry

Nazwa	Typ	Opis
`emailAddresses`	`String[]`	Tablica adresów e-mail użytkowników do dodania.

Zwróć

Spreadsheet – to Spreadsheet do łańcucha.

Upoważnienie

Skrypty, które używają 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

`addMenu(name, subMenus)`

Tworzy nowe menu w interfejsie arkusza kalkulacyjnego.

Każda pozycja menu uruchamia funkcję zdefiniowaną przez użytkownika. Zwykle funkcję tę należy wywołać za pomocą funkcji onOpen(), aby menu było tworzone automatycznie po wczytaniu arkusza kalkulacyjnego.

// The onOpen function is executed automatically every time a Spreadsheet is loaded
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var menuEntries = [];
  // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is
  // executed.
  menuEntries.push({name: "Menu Entry 1", functionName: "function1"});
  menuEntries.push(null); // line separator
  menuEntries.push({name: "Menu Entry 2", functionName: "function2"});

  ss.addMenu("addMenuExample", menuEntries);
}

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa menu do utworzenia.
`subMenus`	`Object[]`	Tablica map JavaScript z parametrami `name` i `functionName`. Możesz użyć funkcji z dołączonych bibliotek, takich jak `Library.libFunction1`.

Upoważnienie

Skrypty, które używają 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

`addViewer(emailAddress)`

Dodaje danego użytkownika do listy widzów elementu Spreadsheet. Jeśli użytkownik był już na liście edytorów, ta metoda nie ma żadnego efektu.

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, którego chcesz dodać.

Zwróć

Spreadsheet – to Spreadsheet do łańcucha.

Upoważnienie

Skrypty, które używają 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

`addViewer(user)`

Dodaje danego użytkownika do listy widzów elementu Spreadsheet. Jeśli użytkownik był już na liście edytorów, ta metoda nie ma żadnego efektu.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika do dodania.

Zwróć

Spreadsheet – to Spreadsheet do łańcucha.

Upoważnienie

Skrypty, które używają 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

`addViewers(emailAddresses)`

Dodaje określoną tablicę użytkowników do listy widzów elementu Spreadsheet. Jeśli którykolwiek użytkownik był już na liście edytorów, ta metoda nie będzie miała wpływu na jego konto.

Parametry

Nazwa	Typ	Opis
`emailAddresses`	`String[]`	Tablica adresów e-mail użytkowników do dodania.

Zwróć

Spreadsheet – to Spreadsheet do łańcucha.

Upoważnienie

Skrypty, które używają 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

`appendRow(rowContents)`

Dołącza wiersz na dole bieżącego regionu danych w arkuszu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Appends a new row with 3 columns to the bottom of the current
// data region in the sheet containing the values in the array.
sheet.appendRow(["a man", "a plan", "panama"]);

Parametry

Nazwa	Typ	Opis
`rowContents`	`Object[]`	Tablica wartości, które należy wstawić po ostatnim wierszu arkusza.

Zwróć

Sheet – arkusz przydatny do łańcucha metod.

Upoważnienie

Skrypty, które używają 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(columnPosition)`

Ustawia szerokość danej kolumny, aby dopasować ją do jej zawartości.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...');

// Sets the first column to a width which fits the text
sheet.autoResizeColumn(1);

Parametry

Nazwa	Typ	Opis
`columnPosition`	`Integer`	Pozycja danej kolumny, której rozmiar chcesz zmienić.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`copy(name)`

Skopiuje arkusz kalkulacyjny i zwraca nowy.

// This code makes a copy of the current spreadsheet and names it appropriately
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.copy("Copy of " + ss.getName());

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa kopii.

Zwróć

Spreadsheet – ten arkusz kalkulacyjny na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają 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

`createDeveloperMetadataFinder()`

Zwraca wartość DeveloperMetadataFinder, aby znaleźć metadane dewelopera w zakresie tego arkusza kalkulacyjnego. Domyślnie uwzględniane są wszystkie metadane powiązane z arkuszem kalkulacyjnym, arkuszami, wierszami i kolumnami.

Zwróć

DeveloperMetadataFinder – narzędzie do wyszukiwania metadanych dewelopera, które umożliwia wyszukiwanie metadanych z poziomu tego arkusza kalkulacyjnego.

`createTextFinder(findText)`

Tworzy wyszukiwarkę tekstu dla arkusza kalkulacyjnego, która służy do znajdowania i zastępowania tekstu w arkuszu kalkulacyjnym. Wyszukiwanie rozpoczyna się od pierwszego arkusza arkusza kalkulacyjnego.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

// Creates  a text finder.
var textFinder = spreadsheet.createTextFinder('dog');

// Returns the first occurrence of 'dog' in the spreadsheet.
var firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var numOccurrencesReplaced = findOccurrence.replaceWith('cat');

Parametry

Nazwa	Typ	Opis
`findText`	`String`	Tekst do wyszukania.

Zwróć

TextFinder – TextFinder w arkuszu kalkulacyjnym.

`deleteActiveSheet()`

Usuwa aktualnie aktywny arkusz.

// The code below deletes the currently active sheet and stores the new active sheet in a
// variable
var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();

Zwróć

Sheet – nowy aktywny arkusz.

Upoważnienie

Skrypty, które używają 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

`deleteColumn(columnPosition)`

Usuwa kolumnę na danej pozycji.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first column
sheet.deleteColumn(1);

Parametry

Nazwa	Typ	Opis
`columnPosition`	`Integer`	Pozycja kolumny od 1 w pierwszej kolumnie.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`deleteColumns(columnPosition, howMany)`

Usuwa kilka kolumn, które zaczynają się od danej pozycji.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first two columns
sheet.deleteColumns(1, 2);

Parametry

Nazwa	Typ	Opis
`columnPosition`	`Integer`	Pozycja pierwszej kolumny do usunięcia.
`howMany`	`Integer`	Liczba kolumn do usunięcia.

Upoważnienie

Skrypty, które używają 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

`deleteRow(rowPosition)`

Usuwa wiersz z danej pozycji.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first row
sheet.deleteRow(1);

Parametry

Nazwa	Typ	Opis
`rowPosition`	`Integer`	Pozycja wiersza, która zaczyna się od 1 w pierwszym wierszu.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`deleteRows(rowPosition, howMany)`

Usuwa kilka wierszy z danej pozycji.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first two rows
sheet.deleteRows(1, 2);

Parametry

Nazwa	Typ	Opis
`rowPosition`	`Integer`	Pozycja pierwszego wiersza do usunięcia.
`howMany`	`Integer`	Liczba wierszy do usunięcia.

Upoważnienie

Skrypty, które używają 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

`deleteSheet(sheet)`

Usuwa określony arkusz.

// The code below deletes the specified sheet.
var ss = SpreadsheetApp.getActive();
var sheet = ss.getSheetByName('My Sheet');
ss.deleteSheet(sheet);

Parametry

Nazwa	Typ	Opis
`sheet`	`Sheet`	Arkusz do usunięcia.

Upoważnienie

Skrypty, które używają 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

`duplicateActiveSheet()`

Powoduje utworzenie duplikatu aktywnego arkusza i utworzenie z niego aktywnego arkusza.

// The code below makes a duplicate of the active sheet
SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();

Zwróć

Sheet – nowy arkusz.

Upoważnienie

Skrypty, które używają 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

`getActiveCell()`

Zwraca aktywną komórkę w tym arkuszu.

Uwaga: zalecane jest użycie getCurrentCell(), które zwróci podświetloną komórkę.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Returns the active cell
var cell = sheet.getActiveCell();

Zwróć

Range – bieżąca aktywna komórka,

Upoważnienie

Skrypty, które używają 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

`getActiveRange()`

Zwraca wybrany zakres w aktywnym arkuszu lub null, jeśli nie ma aktywnego zakresu. Jeśli wybierzesz wiele zakresów, ta metoda zwróci tylko ostatni wybrany zakres.

Termin „aktywny zakres” odnosi się do zakresu wybranego przez użytkownika w aktywnym arkuszu, a w funkcji niestandardowej dotyczy aktywnej komórki przeliczanej.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var activeRange = sheet.getActiveRange();

Zwróć

Range – aktywny zakres

Upoważnienie

Skrypty, które używają 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

Zobacz też

setActiveRange(range)

`getActiveRangeList()`

Zwraca listę aktywnych zakresów w aktywnym arkuszu lub zmienną null, jeśli nie ma aktywnych zakresów.

Jeśli wybierzesz jeden zakres, będzie to działać jako wywołanie getActiveRange().

var sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
var activeRangeList = sheet.getActiveRangeList();

Zwróć

RangeList – lista aktywnych zakresów.

Upoważnienie

Skrypty, które używają 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

Zobacz też

setActiveRangeList(rangeList)

`getActiveSheet()`

Pobiera aktywny arkusz w arkuszu kalkulacyjnym.

Aktywny arkusz kalkulacyjny to arkusz wyświetlany w interfejsie arkusza kalkulacyjnego.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();

Zwróć

Sheet – aktywny arkusz w arkuszu kalkulacyjnym.

`getAs(contentType)`

Zwraca dane wewnątrz tego obiektu w postaci obiektu blob przekonwertowanego na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, np. „mojplik.pdf”. Zakładamy jednak, że część nazwy pliku występująca po ostatnim okresie (jeśli istnieje) to istniejące rozszerzenie, które należy zastąpić. W związku z tym adres „ShoppingList.12.25.2014” zmieni się na „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zobacz Limity dla usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte ograniczeniami.

Parametry

Nazwa	Typ	Opis
`contentType`	`String`	Typ MIME, na który chcesz przekonwertować plik. W większości blobów jedyną prawidłową opcją jest `'application/pdf'`. W przypadku obrazów w formatach BMP, GIF, JPEG lub PNG prawidłowe są również te formaty: `'image/bmp'`, `'image/gif'`, `'image/jpeg'` i `'image/png'`.

Zwróć

Blob – dane jako obiekt blob.

`getBandings()`

Zwraca wszystkie pasma w tym arkuszu kalkulacyjnym.

Zwróć

Banding[] – pasma w tym arkuszu kalkulacyjnym.

Upoważnienie

Skrypty, które używają 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

`getBlob()`

Zwróć dane wewnątrz tego obiektu jako obiekt blob.

Zwróć

Blob – dane jako obiekt blob.

`getColumnWidth(columnPosition)`

Pobiera szerokość pikseli w danej kolumnie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Columns start at 1
Logger.log(sheet.getColumnWidth(1));

Parametry

Nazwa	Typ	Opis
`columnPosition`	`Integer`	Pozycja kolumny do sprawdzenia.

Zwróć

Integer – szerokość kolumny w pikselach,

Upoważnienie

Skrypty, które używają 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

`getCurrentCell()`

Zwraca aktualną komórkę w aktywnym arkuszu lub atrybut null, jeśli nie ma bieżącej komórki. Bieżąca komórka to komórka, która jest zaznaczona w interfejsie Arkuszy Google i jest podświetlona przez ciemne obramowanie. Do chwili obecnej nie ma więcej niż jednej komórki. Gdy użytkownik zaznaczy co najmniej jeden zakres komórek, jedną z zaznaczonych komórek będzie bieżąca komórka.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
// Returns the current highlighted cell in the one of the active ranges.
var currentCell = sheet.getCurrentCell();

Zwróć

Range – bieżąca komórka,

Upoważnienie

Skrypty, które używają 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

`getDataRange()`

Zwraca wartość Range odpowiadającą wymiarom, dla których są dostępne dane.

Jest to równoznaczne z utworzeniem zakresu ograniczonego przez A1 i (Sheet.getLastColumn(), Sheet.getLastRow()).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This represents ALL the data
var range = sheet.getDataRange();
var values = range.getValues();

// This logs the spreadsheet in CSV format with a trailing comma
for (var i = 0; i < values.length; i++) {
  var row = "";
  for (var j = 0; j < values[i].length; j++) {
    if (values[i][j]) {
      row = row + values[i][j];
    }
    row = row + ",";
  }
  Logger.log(row);
}

Zwróć

Range – zakres obejmujący wszystkie dane z arkusza kalkulacyjnego

Upoważnienie

Skrypty, które używają 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

`getDataSourceFormulas()`

Pobiera wszystkie formuły źródła danych.

Zwróć

DataSourceFormula[] – lista formuł źródeł danych.

Upoważnienie

Skrypty, które używają 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

`getDataSourcePivotTables()`

Pobiera wszystkie tabele przestawne źródeł danych.

Zwróć

DataSourcePivotTable[] – lista tabel przestawnych źródeł danych.

Upoważnienie

Skrypty, które używają 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

`getDataSourceRefreshSchedules()`

Pobiera harmonogramy odświeżania tego arkusza kalkulacyjnego.

Zwróć

DataSourceRefreshSchedule[] – harmonogramy odświeżania tego arkusza kalkulacyjnego.

Upoważnienie

Skrypty, które używają 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 wszystkie arkusze źródeł danych w arkuszu kalkulacyjnym.

Zwróć

DataSourceSheet[] – tablica wszystkich arkuszy źródeł danych.

Upoważnienie

Skrypty, które używają 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

`getDataSourceTables()`

Pobiera wszystkie tabele źródeł danych.

Zwróć

DataSourceTable[] – lista tabel źródeł danych,

Upoważnienie

Skrypty, które używają 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

`getDataSources()`

Zwraca wszystkie źródła danych w arkuszu kalkulacyjnym.

Zwróć

DataSource[] – tablica wszystkich źródeł danych.

Upoważnienie

Skrypty, które używają 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

`getDeveloperMetadata()`

Pobierz metadane dewelopera powiązane z arkuszem kalkulacyjnym najwyższego poziomu.

Zwróć

DeveloperMetadata[] – metadane dewelopera powiązane z tym zakresem,

Upoważnienie

Skrypty, które używają 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

`getEditors()`

Pobiera listę edytorów tego pliku (Spreadsheet).

Zwróć

User[] – tablica użytkowników z uprawnieniami do edycji.

Upoważnienie

Skrypty, które używają 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

`getFormUrl()`

Zwraca URL formularza, który wysyła odpowiedzi z tego arkusza kalkulacyjnego, lub null, jeśli nie ma powiązanego formularza. Jeśli do arkusza kalkulacyjnego są wysyłane odpowiedzi z wielu formularzy, zwracany URL formularza jest nieokreślony. Zamiast tego powiązania adresów URL z arkusza kalkulacyjnego można pobrać za pomocą metody Sheet.getFormUrl().

Zwróć

String – adres URL formularza, który umieścił odpowiedzi w tym arkuszu kalkulacyjnym, lub null, jeśli ten arkusz kalkulacyjny nie ma powiązanego formularza.

Upoważnienie

Skrypty, które używają 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

`getFrozenColumns()`

Zwraca liczbę zablokowanych kolumn.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());

Zwróć

Integer – liczba zablokowanych kolumn,

Upoważnienie

Skrypty, które używają 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

`getFrozenRows()`

Zwraca liczbę zablokowanych wierszy.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());

Zwróć

Integer – liczba zablokowanych wierszy,

Upoważnienie

Skrypty, które używają 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

`getId()`

Pobiera unikalny identyfikator tego arkusza kalkulacyjnego. Identyfikator arkusza kalkulacyjnego można wyodrębnić z jego adresu URL. Na przykład identyfikator arkusza kalkulacyjnego w adresie URL https://docs.google.com/spreadsheet/d/abc1234567/edit#gid=0 to „abc1234567”.

// The code below logs the ID for the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());

Zwróć

String – unikalny identyfikator (lub klucz) arkusza kalkulacyjnego.

`getImages()`

Zwraca wszystkie obrazy poza siatką arkusza.

Zwróć

OverGridImage[] – tablica obrazów ponad siatką.

Upoważnienie

Skrypty, które używają 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

`getIterativeCalculationConvergenceThreshold()`

Zwraca wartość progową używaną podczas obliczania iteracyjnego. Gdy wyniki kolejnych obliczeń różnią się od tej wartości, obliczenia iteracyjne zostają zatrzymane.

Zwróć

Number – próg konwersji,

Upoważnienie

Skrypty, które używają 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

`getLastColumn()`

Zwraca pozycję ostatniej kolumny, która zawiera treści.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Zwróć

Integer – ostatnia kolumna w arkuszu zawierającym treść

Upoważnienie

Skrypty, które używają 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

`getLastRow()`

Zwraca pozycję ostatniego wiersza z treścią.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Zwróć

Integer – ostatni wiersz arkusza zawierającego treść

Upoważnienie

Skrypty, które używają 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

`getMaxIterativeCalculationCycles()`

Zwraca maksymalną liczbę iteracji używanych podczas obliczania iteracyjnego.

Zwróć

Integer – maksymalna liczba iteracji obliczeń.

Upoważnienie

Skrypty, które używają 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

`getName()`

Pobiera nazwę dokumentu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getName());

Zwróć

String – nazwa arkusza kalkulacyjnego.

Upoważnienie

Skrypty, które używają 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

`getNamedRanges()`

Pobiera wszystkie nazwane zakresy w tym arkuszu kalkulacyjnym.

// The code below logs the name of the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
  Logger.log(namedRanges[i].getName());
}

Zwróć

NamedRange[] – tablica wszystkich nazwanych zakresów w arkuszu kalkulacyjnym.

Upoważnienie

Skrypty, które używają 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

`getNumSheets()`

Zwraca liczbę arkuszy w tym arkuszu kalkulacyjnym.

// The code below logs the number of sheets in the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());

Zwróć

Integer – liczba arkuszy w arkuszu kalkulacyjnym,

`getOwner()`

Zwraca właściciela dokumentu lub parametr null dokumentu w przypadku dysku współdzielonego.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var owner = ss.getOwner();
Logger.log(owner.getEmail());

Zwróć

User – właściciel dokumentu lub null, jeśli dokument znajduje się na dysku współdzielonym.

Upoważnienie

Skrypty, które używają 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

`getPredefinedSpreadsheetThemes()`

Zwraca listę wstępnie zdefiniowanych motywów.

// The code below returns the list of predefined themes.
var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet()
                               .getPredefinedSpreadsheetThemes();

Zwróć

SpreadsheetTheme[] – lista wstępnie zdefiniowanych motywów.

Upoważnienie

Skrypty, które używają 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

`getProtections(type)`

Pobiera tablicę obiektów reprezentujących wszystkie chronione zakresy lub arkusze w arkuszu kalkulacyjnym.

// Remove all range protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

// Remove all sheet protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

Parametry

Nazwa	Typ	Opis
`type`	`ProtectionType`	Typ obszaru chronionego: `SpreadsheetApp.ProtectionType.RANGE` lub `SpreadsheetApp.ProtectionType.SHEET`.

Zwróć

Protection[] – tablica obiektów reprezentujących wszystkie chronione zakresy lub arkusze w arkuszu kalkulacyjnym.

Upoważnienie

Skrypty, które używają 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

`getRange(a1Notation)`

Zwraca zakres określony w notacji A1 lub notacji R1C1.

// Get a range A1:D4 on sheet titled "Invoices"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var range = ss.getRange("Invoices!A1:D4");

// Get cell A1 on the first sheet
var sheet = ss.getSheets()[0];
var cell = sheet.getRange("A1");

Parametry

Nazwa	Typ	Opis
`a1Notation`	`String`	Zakres zwrotu zgodnie z zapisem A1 lub notacją R1C1.

Zwróć

Range – zakres w wybranej lokalizacji

Upoważnienie

Skrypty, które używają 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

`getRangeByName(name)`

Zwraca zakres nazwany lub null, jeśli nie znaleziono zakresu o podanej nazwie. Jeśli wiele arkuszy w arkuszu ma tę samą nazwę zakresu, określ nazwę arkusza bez dodatkowych cudzysłowów – na przykład getRangeByName('TaxRates') lub getRangeByName('Sheet Name!TaxRates') – nie getRangeByName('"Sheet Name"!TaxRates').

// Log the number of columns for the range named 'TaxRates' in the active spreadsheet.
var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates');
if (range != null) {
  Logger.log(range.getNumColumns());
}

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa zakresu do uzyskania.

Zwróć

Range – zakres komórek o danej nazwie,

`getRangeList(a1Notations)`

Zwraca kolekcję RangeList reprezentującą zakresy w tym samym arkuszu określonym przez niepustą listę notacji A1 lub notacji R1C1.

// Get a list of ranges A1:D4, F1:H4.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var rangeList  = sheet.getRangeList(['A1:D4', 'F1:H4']);

Parametry

Nazwa	Typ	Opis
`a1Notations`	`String[]`	Lista zakresów do zwrócenia, zgodnie z notacją A1 lub notacją R1C1.

Zwróć

RangeList – lista zakresów w wybranej lokalizacji;

Upoważnienie

Skrypty, które używają 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

`getRecalculationInterval()`

Zwraca przedział obliczeowy tego arkusza kalkulacyjnego.

Zwróć

RecalculationInterval – interwał obliczeniowy tego arkusza kalkulacyjnego.

Upoważnienie

Skrypty, które używają 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

`getRowHeight(rowPosition)`

Pobiera wysokość w pikselach danego wiersza.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Rows start at 1
Logger.log(sheet.getRowHeight(1));

Parametry

Nazwa	Typ	Opis
`rowPosition`	`Integer`	Pozycja wiersza do sprawdzenia.

Zwróć

Integer – wysokość wiersza w pikselach,

Upoważnienie

Skrypty, które używają 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

`getSelection()`

Zwraca aktualną wartość Selection w arkuszu kalkulacyjnym.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var currentCell = selection.getCurrentCell();

Zwróć

Selection – bieżący wybór

Upoważnienie

Skrypty, które używają 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

`getSheetByName(name)`

Zwraca arkusz o podanej nazwie.

Jeśli kilka arkuszy ma taką samą nazwę, zostanie zwrócony plik po lewej stronie. Zwraca wartość null, jeśli nie ma arkusza o podanej nazwie.

// The code below logs the index of a sheet named "Expenses"
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses");
if (sheet != null) {
  Logger.log(sheet.getIndex());
}

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa arkusza, który chcesz pobrać.

Zwróć

Sheet – arkusz o podanej nazwie.

`getSheetId()`

Zwraca identyfikator arkusza reprezentowanego przez ten obiekt.

Jest to unikalny identyfikator arkusza. Jest to monotonnie rosnąca liczba całkowita przypisana podczas tworzenia arkusza i jest niezależna od pozycji arkusza. Jest to przydatne w połączeniu z metodami takimi jak Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd), które przyjmują parametr gridId zamiast instancji Sheet.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log(sheet.getSheetId());

Zwróć

Integer – identyfikator arkusza unikalny dla arkusza kalkulacyjnego.

Upoważnienie

Skrypty, które używają 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

`getSheetName()`

Zwraca nazwę arkusza.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log(sheet.getSheetName());

Zwróć

String – nazwa arkusza;

Upoważnienie

Skrypty, które używają 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(startRow, startColumn, numRows, numColumns)`

Zwraca prostokątną siatkę wartości dla tego zakresu rozpoczynającego się od podanych współrzędnych. Wartość -1 podana jako pozycja wiersza lub kolumny jest taka sama jak w przypadku ostatniego wiersza lub kolumny z danymi w arkuszu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The two samples below produce the same output
var values = sheet.getSheetValues(1, 1, 3, 3);
Logger.log(values);

var range = sheet.getRange(1, 1, 3, 3);
values = range.getValues();
Logger.log(values);

Parametry

Nazwa	Typ	Opis
`startRow`	`Integer`	Pozycja wiersza początkowego.
`startColumn`	`Integer`	Pozycja kolumny początkowej.
`numRows`	`Integer`	Liczba wierszy, których wartości mają zostać zwrócone.
`numColumns`	`Integer`	Liczba kolumn, dla których mają być zwracane wartości.

Zwróć

Object[][] – dwuwymiarowa tablica wartości,

Upoważnienie

Skrypty, które używają 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

`getSheets()`

Pobiera wszystkie arkusze z tego arkusza kalkulacyjnego.

// The code below logs the name of the second sheet
var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
if (sheets.length > 1) {
  Logger.log(sheets[1].getName());
}

Zwróć

Sheet[] – tablica wszystkich arkuszy w arkuszu kalkulacyjnym,

`getSpreadsheetLocale()`

Pobiera język arkusza kalkulacyjnego.

Zwróć

String – język arkusza kalkulacyjnego;

Upoważnienie

Skrypty, które używają 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

`getSpreadsheetTheme()`

Zwraca bieżący motyw arkusza kalkulacyjnego lub null, jeśli nie został on dodany.

// The code below returns the current theme of the spreadsheet.
var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();

Zwróć

SpreadsheetTheme – aktualnie zastosowany motyw.

Upoważnienie

Skrypty, które używają 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

`getSpreadsheetTimeZone()`

Pobiera strefę czasową arkusza kalkulacyjnego.

Zwróć

String – strefa czasowa podana w formacie „długim” (np. „Ameryka/Nowy_Jork”, zgodnie z informacjami w domenie Joda.org);

Upoważnienie

Skrypty, które używają 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

`getUrl()`

Zwraca adres URL określonego arkusza kalkulacyjnego.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getUrl());

Zwróć

String – adres URL danego arkusza kalkulacyjnego.

Upoważnienie

Skrypty, które używają 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

`getViewers()`

Pobiera listę widzów i komentarzy do filmu Spreadsheet.

Zwróć

User[] – tablica użytkowników z uprawnieniami do wyświetlania lub komentowania.

Upoważnienie

Skrypty, które używają 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

`hideColumn(column)`

Ukrywa kolumny lub kolumny w danym zakresie.

let ss = SpreadsheetApp.getActiveSpreadsheet();
let sheet = ss.getSheets()[0];

// This hides the first column
let range = sheet.getRange("A1");
sheet.hideColumn(range);

// This hides the first 3 columns
let range = sheet.getRange("A:C");
sheet.hideColumn(range);

Parametry

Nazwa	Typ	Opis
`column`	`Range`	Zakres kolumn do ukrycia.

Upoważnienie

Skrypty, które używają 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

`hideRow(row)`

Ukrywa wiersze w danym zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This hides the first row
var range = sheet.getRange("A1");
sheet.hideRow(range);

Parametry

Nazwa	Typ	Opis
`row`	`Range`	Zakres wierszy do ukrycia.

Upoważnienie

Skrypty, które używają 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

`insertColumnAfter(afterPosition)`

Wstawia kolumnę za określoną pozycją kolumny.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a column after the first column position
sheet.insertColumnAfter(1);

Parametry

Nazwa	Typ	Opis
`afterPosition`	`Integer`	Kolumna, za którą należy dodać nową kolumnę.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`insertColumnBefore(beforePosition)`

Wstawia kolumnę przed określoną pozycją kolumny.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a column in the first column position
sheet.insertColumnBefore(1);

Parametry

Nazwa	Typ	Opis
`beforePosition`	`Integer`	Kolumna, przed którą chcesz dodać nową kolumnę.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`insertColumnsAfter(afterPosition, howMany)`

Wstawia liczbę kolumn po określonej pozycji kolumny.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a column in the second column position
sheet.insertColumnsAfter(1);

Parametry

Nazwa	Typ	Opis
`afterPosition`	`Integer`	Kolumna, za którą należy dodać nową kolumnę.
`howMany`	`Integer`	Liczba kolumn do wstawienia.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`insertColumnsBefore(beforePosition, howMany)`

Wstawia określoną liczbę kolumn przed daną pozycją.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts five columns before the first column
sheet.insertColumnsBefore(1, 5);

Parametry

Nazwa	Typ	Opis
`beforePosition`	`Integer`	Kolumna, przed którą chcesz dodać nową kolumnę.
`howMany`	`Integer`	Liczba kolumn do wstawienia.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`insertDataSourceSheet(spec)`

Wstawienie nowego arkusza DataSourceSheet w arkuszu kalkulacyjnym i rozpoczęcie wykonywania danych. Efektem ubocznym jest też aktywowanie nowego arkusza.

Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Aby włączyć wykonywanie danych dla określonego typu źródła danych, użyj metod SpreadsheetApp#enable...Execution().

Parametry

Nazwa	Typ	Opis
`spec`	`DataSourceSpec`	Specyfikacja źródła danych do wstawienia.

Zwróć

DataSourceSheet – nowy arkusz źródła danych.

Upoważnienie

Skrypty, które używają 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

`insertImage(blobSource, column, row)`

Wstawia Spreadsheet jako obraz w dokumencie w danym wierszu i kolumnie. Rozmiar obrazu jest pobierany z zawartości bloba. Maksymalny obsługiwany rozmiar blob to 2 MB.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1);

Parametry

Nazwa	Typ	Opis
`blobSource`	`BlobSource`	Obiekt blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę.
`column`	`Integer`	Pozycja kolumny.
`row`	`Integer`	Pozycja wiersza.

Zwróć

OverGridImage – wstawiony obraz.

Upoważnienie

Skrypty, które używają 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

`insertImage(blobSource, column, row, offsetX, offsetY)`

Wstawia Spreadsheet jako obraz w danym dokumencie w danym wierszu i w kolumnie z przesunięciem pikseli. Rozmiar obrazu jest pobierany z zawartości bloba. Maksymalny obsługiwany rozmiar bloba to 2 MB.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1, 10, 10);

Parametry

Nazwa	Typ	Opis
`blobSource`	`BlobSource`	Obiekt blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę.
`column`	`Integer`	Pozycja kolumny.
`row`	`Integer`	Pozycja wiersza.
`offsetX`	`Integer`	Przesunięcie w poziomie względem rogu komórki w pikselach.
`offsetY`	`Integer`	Przesunięcie w pionie od rogu komórki w pikselach.

Zwróć

OverGridImage – wstawiony obraz.

Upoważnienie

Skrypty, które używają 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

`insertImage(url, column, row)`

Wstawia obraz w dokumencie w danym wierszu i kolumnie.

Podany URL musi być dostępny publicznie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);

Parametry

Nazwa	Typ	Opis
`url`	`String`	Adres URL obrazu.
`column`	`Integer`	Pozycja kolumny siatki.
`row`	`Integer`	Pozycja wiersza siatki.

Zwróć

OverGridImage – wstawiony obraz.

Upoważnienie

Skrypty, które używają 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

`insertImage(url, column, row, offsetX, offsetY)`

Wstawia obraz w dokumencie w danym wierszu i w kolumnie z przesunięciem piksela.

Podany URL musi być dostępny publicznie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);

Parametry

Nazwa	Typ	Opis
`url`	`String`	Adres URL obrazu.
`column`	`Integer`	Pozycja kolumny.
`row`	`Integer`	Pozycja wiersza.
`offsetX`	`Integer`	Przesunięcie w poziomie względem rogu komórki w pikselach.
`offsetY`	`Integer`	Przesunięcie w pionie od rogu komórki w pikselach.

Zwróć

OverGridImage – wstawiony obraz.

Upoważnienie

Skrypty, które używają 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

`insertRowAfter(afterPosition)`

Wstawia wiersz po określonej pozycji.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a row after the first row position
sheet.insertRowAfter(1);

Parametry

Nazwa	Typ	Opis
`afterPosition`	`Integer`	Wiersz, po którym należy dodać nowy wiersz.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`insertRowBefore(beforePosition)`

Wstawia wiersz przed daną pozycją w wierszu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a row before the first row position
sheet.insertRowBefore(1);

Parametry

Nazwa	Typ	Opis
`beforePosition`	`Integer`	Wiersz, przed którym należy dodać nowy wiersz.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`insertRowsAfter(afterPosition, howMany)`

Wstawia liczbę wierszy po określonej pozycji wiersza.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts five rows after the first row
sheet.insertRowsAfter(1, 5);

Parametry

Nazwa	Typ	Opis
`afterPosition`	`Integer`	Wiersz, po którym należy dodać nowe wiersze.
`howMany`	`Integer`	Liczba wierszy do wstawienia.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`insertRowsBefore(beforePosition, howMany)`

Wstawia liczbę wierszy przed daną pozycją.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts five rows before the first row
sheet.insertRowsBefore(1, 5);

Parametry

Nazwa	Typ	Opis
`beforePosition`	`Integer`	Wiersz, przed którym chcesz dodać nowe wiersze.
`howMany`	`Integer`	Liczba wierszy do wstawienia.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`insertSheet()`

Wstawia nowy arkusz do arkusza kalkulacyjnego przy użyciu domyślnej nazwy arkusza. Nowy arkusz stanie się aktywny.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet();

Zwróć

Sheet – nowy arkusz.

Upoważnienie

Skrypty, które używają 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

`insertSheet(sheetIndex)`

Wstawia nowy arkusz do arkusza kalkulacyjnego o określonym indeksie. Nowy arkusz stanie się aktywny.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet(1);

Parametry

Nazwa	Typ	Opis
`sheetIndex`	`Integer`	Indeks nowo utworzonego arkusza. Aby wstawić arkusz jako pierwszy w arkuszu kalkulacyjnym, ustaw wartość 0.

Zwróć

Sheet – nowy arkusz.

Upoważnienie

Skrypty, które używają 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

`insertSheet(sheetIndex, options)`

Wstawia nowy arkusz do arkusza kalkulacyjnego w przypadku określonego indeksu i używa opcjonalnych argumentów zaawansowanych. Nowy arkusz stanie się aktywny.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet(1, {template: templateSheet});

Parametry

Nazwa	Typ	Opis
`sheetIndex`	`Integer`	Indeks nowo utworzonego arkusza. Aby wstawić arkusz jako pierwszy w arkuszu kalkulacyjnym, ustaw wartość 0.
`options`	`Object`	Opcjonalne argumenty JavaScriptu zaawansowanego.

Parametry zaawansowane

Nazwa	Typ	Opis
`template`	`Sheet`	Wszystkie dane z obiektu arkusza szablonu zostaną skopiowane do nowego arkusza. Szablon arkusza musi być jednym z arkuszy obiektu obiektu Arkusz kalkulacyjny.

Zwróć

Sheet – nowy arkusz.

Upoważnienie

Skrypty, które używają 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

`insertSheet(options)`

Wstawia nowy arkusz do arkusza kalkulacyjnego przy użyciu domyślnej nazwy arkusza i opcjonalnych argumentów zaawansowanych. Nowy arkusz stanie się aktywny.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet({template: templateSheet});

Parametry

Nazwa	Typ	Opis
`options`	`Object`	Opcjonalne argumenty JavaScriptu zaawansowanego wymienione poniżej.

Parametry zaawansowane

Nazwa	Typ	Opis
`template`	`Sheet`	Wszystkie dane z obiektu arkusza szablonu zostaną skopiowane do nowego arkusza. Szablon arkusza musi być jednym z arkuszy tego obiektu arkusza kalkulacyjnego.

Zwróć

Sheet – nowy arkusz.

Upoważnienie

Skrypty, które używają 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

`insertSheet(sheetName)`

Wstawia nowy arkusz do arkusza kalkulacyjnego o podanej nazwie. Nowy arkusz stanie się aktywny.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet');

Parametry

Nazwa	Typ	Opis
`sheetName`	`String`	Nazwa nowego arkusza.

Zwróć

Sheet – nowy arkusz.

Upoważnienie

Skrypty, które używają 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

`insertSheet(sheetName, sheetIndex)`

Wstawia do arkusza kalkulacyjnego nowy arkusz o danej nazwie w danym indeksie. Nowy arkusz staje się aktywnym arkuszem.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet', 1);

Parametry

Nazwa	Typ	Opis
`sheetName`	`String`	Nazwa nowego arkusza.
`sheetIndex`	`Integer`	Indeks nowo utworzonego arkusza. Aby wstawić arkusz jako pierwszy w arkuszu kalkulacyjnym, ustaw wartość 0.

Zwróć

Sheet – nowy arkusz.

Upoważnienie

Skrypty, które używają 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

`insertSheet(sheetName, sheetIndex, options)`

Wstawia nowy arkusz do arkusza kalkulacyjnego o danej nazwie w danym indeksie i stosuje opcjonalne argumenty zaawansowane. Nowy arkusz stanie się aktywny.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', 1, {template: templateSheet});

Parametry

Nazwa	Typ	Opis
`sheetName`	`String`	Nazwa nowego arkusza.
`sheetIndex`	`Integer`	Indeks nowo wstawianego arkusza. Aby wstawić arkusz jako pierwszy w arkuszu kalkulacyjnym, ustaw wartość 0.
`options`	`Object`	Opcjonalne argumenty JavaScriptu zaawansowanego.

Parametry zaawansowane

Nazwa	Typ	Opis
`template`	`Sheet`	Wszystkie dane z obiektu arkusza szablonu zostaną skopiowane do nowego arkusza. Szablon arkusza musi być jednym z arkuszy obiektu obiektu Arkusz kalkulacyjny.

Zwróć

Sheet – nowy arkusz.

Upoważnienie

Skrypty, które używają 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

`insertSheet(sheetName, options)`

Wstawia nowy arkusz do arkusza kalkulacyjnego o podanej nazwie i stosuje opcjonalne argumenty zaawansowane. Nowy arkusz stanie się aktywny.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', {template: templateSheet});

Parametry

Nazwa	Typ	Opis
`sheetName`	`String`	Nazwa nowego arkusza.
`options`	`Object`	Opcjonalne argumenty JavaScriptu zaawansowanego.

Parametry zaawansowane

Nazwa	Typ	Opis
`template`	`Sheet`	Wszystkie dane z obiektu arkusza szablonu zostaną skopiowane do nowego arkusza. Szablon arkusza musi być jednym z arkuszy obiektu obiektu Arkusz kalkulacyjny.

Zwróć

Sheet – nowy arkusz.

Upoważnienie

Skrypty, które używają 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

`insertSheetWithDataSourceTable(spec)`

Wstawia nowy arkusz w arkuszu kalkulacyjnym, tworzy DataSourceTable obejmujący cały arkusz o danej specyfikacji źródła danych i uruchamia dane. Efektem ubocznym jest ustawienie nowego arkusza jako aktywnego.

Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Aby włączyć wykonywanie danych dla określonego typu źródła danych, użyj metod SpreadsheetApp#enable...Execution().

Parametry

Nazwa	Typ	Opis
`spec`	`DataSourceSpec`	Specyfikacja źródła danych do wstawienia.

Zwróć

Sheet – nowy arkusz.

Upoważnienie

Skrypty, które używają 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

`isColumnHiddenByUser(columnPosition)`

Zwraca wartość, która wskazuje, czy dana kolumna jest ukryta przez użytkownika.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Columns start at 1
Logger.log(sheet.isColumnHiddenByUser(1));

Parametry

Nazwa	Typ	Opis
`columnPosition`	`Integer`	Pozycja kolumny do sprawdzenia.

Zwróć

Boolean – true, jeśli kolumna jest ukryta, w przeciwnym razie false.

Upoważnienie

Skrypty, które używają 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

`isIterativeCalculationEnabled()`

Zwraca, czy w tym arkuszu kalkulacyjnym włączone są obliczenia iteracyjne.

Zwróć

Boolean – true, jeśli obliczenia iteracyjne są włączone, false – w przeciwnym razie.

Upoważnienie

Skrypty, które używają 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

`isRowHiddenByFilter(rowPosition)`

Zwraca, czy dany wiersz jest ukryty przez filtr (a nie w widoku filtra).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Rows start at 1
Logger.log(sheet.isRowHiddenByFilter(1));

Parametry

Nazwa	Typ	Opis
`rowPosition`	`Integer`	Pozycja wiersza do sprawdzenia.

Zwróć

Boolean – true, jeśli wiersz jest ukryty, w przeciwnym razie – false.

Upoważnienie

Skrypty, które używają 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

`isRowHiddenByUser(rowPosition)`

Wskazuje, czy dany wiersz jest ukryty przez użytkownika.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Rows start at 1
Logger.log(sheet.isRowHiddenByUser(1));

Parametry

Nazwa	Typ	Opis
`rowPosition`	`Integer`	Pozycja wiersza do sprawdzenia.

Zwróć

Boolean – true, jeśli wiersz jest ukryty, w przeciwnym razie – false.

Upoważnienie

Skrypty, które używają 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

`moveActiveSheet(pos)`

Przenosi aktywny arkusz na określoną pozycję na liście arkuszy. Zgłasza wyjątek, jeśli pozycja jest ujemna lub większa niż liczba arkuszy.

// This example assumes that there are 2 sheets in the current
// active spreadsheet: one named "first" in position 1 and another named "second"
// in position 2.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// Gets the "first" sheet and activates it.
var sheet = spreadsheet.getSheetByName("first").activate();

// Logs 'Current index of sheet: 1'
console.log("Current index of sheet: %s", sheet.getIndex());

spreadsheet.moveActiveSheet(2);

// Logs 'New index of sheet: 2'
console.log("New index of sheet: %s", sheet.getIndex());

Parametry

Nazwa	Typ	Opis
`pos`	`Integer`	Pozycja indeksu 1 indeksu, na którą chcesz przenieść aktywny arkusz na liście arkuszy.

Upoważnienie

Skrypty, które używają 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

`moveChartToObjectSheet(chart)`

Tworzy nowy arkusz SheetType.OBJECT i przenosi do niego podany wykres. Jeśli wykres znajduje się już w osobnym arkuszu, zostanie on zwrócony bez tworzenia nowego.

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.newChart().setPosition(1, 1, 0, 0).build();
sheet.insertChart(chart);
var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);

Parametry

Nazwa	Typ	Opis
`chart`	`EmbeddedChart`	Wykres do przeniesienia.

Zwróć

Sheet – arkusz, na którym znajduje się wykres.

Upoważnienie

Skrypty, które używają 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

`refreshAllDataSources()`

Odświeża wszystkie obsługiwane źródła danych i powiązane z nimi obiekty źródeł danych, pomijając nieprawidłowe obiekty źródeł danych.

Użyj metod SpreadsheetApp#enable...Execution(), aby włączyć wykonywanie danych dla określonego typu źródła danych.

Upoważnienie

Skrypty, które używają 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

`removeEditor(emailAddress)`

Usunięcie użytkownika z listy edytorów Spreadsheet. Ta metoda nie blokuje użytkownikom dostępu do Spreadsheet, jeśli należą do klasy użytkowników z ogólnym dostępem – na przykład gdy Spreadsheet jest udostępniany w całej domenie użytkownika lub gdy Spreadsheet znajduje się na dysku współdzielonym, do którego ten użytkownik ma dostęp.

W przypadku plików na Dysku użytkownik zostanie też usunięty z listy przeglądających.

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, którego chcesz usunąć.

Zwróć

Spreadsheet – to Spreadsheet do łańcucha.

Upoważnienie

Skrypty, które używają 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

`removeEditor(user)`

W przypadku plików na Dysku użytkownik zostanie też usunięty z listy przeglądających.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika do usunięcia.

Zwróć

Spreadsheet – to Spreadsheet do łańcucha.

Upoważnienie

Skrypty, które używają 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

`removeMenu(name)`

Usuwa menu dodane przez użytkownika addMenu(name, subMenus). Argument name powinien mieć tę samą wartość co odpowiednie wywołanie addMenu(name, subMenus).

// The onOpen function is executed automatically every time a Spreadsheet is loaded
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"},
                                       {name: "foo", functionName: "foo"}]);
}
function removeBadMenu() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.removeMenu("badMenu");  // name must match the name used when added the menu
}
function foo(){
// Do nothing
}

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa menu do usunięcia.

Upoważnienie

Skrypty, które używają 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

`removeNamedRange(name)`

Usuwa zakres nazwany o podanej nazwie. Zgłasza wyjątek, jeśli w arkuszu nie znajdzie się zakres o podanej nazwie.

// The code below creates a new named range "foo", and then remove it.
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange("foo", ss.getActiveRange());
ss.removeNamedRange("foo");

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa zakresu.

Upoważnienie

Skrypty, które używają 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

`removeViewer(emailAddress)`

Usunięcie użytkownika z listy widzów i komentujących: Spreadsheet. Ta metoda nie działa, jeśli użytkownik jest edytorem, a nie przeglądającym lub komentującym. Ta metoda nie blokuje też dostępu do Spreadsheet, jeśli należą oni do grupy użytkowników, którzy mają ogólny dostęp (na przykład jeśli Spreadsheet jest udostępniony w całej domenie użytkownika lub Spreadsheet znajduje się na dysku współdzielonym, do którego ten użytkownik ma dostęp).

W przypadku plików na Dysku użytkownik zostanie też usunięty z listy edytorów.

Parametry

Nazwa	Typ	Opis
`emailAddress`	`String`	Adres e-mail użytkownika, którego chcesz usunąć.

Zwróć

Spreadsheet – to Spreadsheet do łańcucha.

Upoważnienie

Skrypty, które używają 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

`removeViewer(user)`

Usunięcie użytkownika z listy widzów i komentujących: Spreadsheet. Ta metoda nie działa, jeśli użytkownik jest edytorem, a nie przeglądającym. Ta metoda również nie blokuje dostępu do zasobu Spreadsheet, jeśli należą oni do grupy użytkowników, którzy mają ogólny dostęp (na przykład jeśli Spreadsheet jest udostępniony w całej domenie użytkownika lub gdy Spreadsheet znajduje się na dysku współdzielonym, do którego ten użytkownik ma dostęp).

W przypadku plików na Dysku użytkownik zostanie też usunięty z listy edytorów.

Parametry

Nazwa	Typ	Opis
`user`	`User`	Reprezentacja użytkownika do usunięcia.

Zwróć

Spreadsheet – to Spreadsheet do łańcucha.

Upoważnienie

Skrypty, które używają 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

`rename(newName)`

Zmienia nazwę dokumentu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.rename("This is the new name");

Parametry

Nazwa	Typ	Opis
`newName`	`String`	Nowa nazwa dokumentu.

Upoważnienie

Skrypty, które używają 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

`renameActiveSheet(newName)`

Zmienia nazwę bieżącego aktywnego arkusza na nową.

// The code below renames the active sheet to "Hello world"
SpreadsheetApp.getActiveSpreadsheet().renameActiveSheet("Hello world");

Parametry

Nazwa	Typ	Opis
`newName`	`String`	Nowa nazwa bieżącego aktywnego arkusza.

Upoważnienie

Skrypty, które używają 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

`resetSpreadsheetTheme()`

Usuwa zastosowany motyw i ustawia motyw domyślny w arkuszu kalkulacyjnym.

// The code below applies default theme on the spreadsheet.
SpreadsheetApp.getActiveSpreadsheet().resetSpreadsheetTheme();

Zwróć

SpreadsheetTheme – motyw domyślny

Upoważnienie

Skrypty, które używają 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

`setActiveRange(range)`

Ustawia aktywny zakres jako active range w aktywnym arkuszu, a lewą górną komórkę w zakresie jako current cell.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var range = sheet.getRange('A1:D4');
sheet.setActiveRange(range);

var selection = sheet.getSelection();
// Current cell: A1
var currentCell = selection.getCurrentCell();
// Active Range: A1:D4
var activeRange = selection.getActiveRange();

Parametry

Nazwa	Typ	Opis
`range`	`Range`	Zakres ustawiony jako aktywny.

Zwróć

Range – nowo aktywny zakres

Upoważnienie

Skrypty, które używają 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

`setActiveRangeList(rangeList)`

Ustawia w aktywnym arkuszu określoną listę zakresów jako active ranges. Ostatni zakres na liście to active range.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
sheet.setActiveRangeList(rangeList);

var selection = sheet.getSelection();
// Current cell: B2
var currentCell = selection.getCurrentCell();
// Active range: B2:C4
var activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
var activeRangeList = selection.getActiveRangeList();

Parametry

Nazwa	Typ	Opis
`rangeList`	`RangeList`	Lista zakresów do wyboru.

Zwróć

RangeList – nowo wybrana lista zakresów,

Upoważnienie

Skrypty, które używają 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

`setActiveSelection(range)`

Określa region aktywnego wyboru w tym arkuszu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D4");
sheet.setActiveSelection(range);

Parametry

Nazwa	Typ	Opis
`range`	`Range`	Zakres ustawiony jako aktywny.

Zwróć

Range – nowo aktywny zakres

Upoważnienie

Skrypty, które używają 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

`setActiveSelection(a1Notation)`

Określa aktywny wybór zgodnie z zapisem A1 lub R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.setActiveSelection("A1:D4");

Parametry

Nazwa	Typ	Opis
`a1Notation`	`String`	Zakres ustawiony jako aktywny określony w notacji A1 lub notacji R1C1.

Zwróć

Range – nowo aktywny zakres

Upoważnienie

Skrypty, które używają 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

`setActiveSheet(sheet)`

Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym. Interfejs Arkuszy Google wyświetla wybrany arkusz, chyba że należy on do innego arkusza.

// The code below makes the first sheet active in the active spreadsheet.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
spreadsheet.setActiveSheet(spreadsheet.getSheets()[0]);

Parametry

Nazwa	Typ	Opis
`sheet`	`Sheet`	Arkusz, który ma zostać ustawiony jako aktywny.

Zwróć

Sheet – aktywny arkusz.

Upoważnienie

Skrypty, które używają 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

`setActiveSheet(sheet, restoreSelection)`

Ustawia dany arkusz jako aktywny w arkuszu kalkulacyjnym z opcją przywrócenia najnowszego zaznaczenia w tym arkuszu. Interfejs Arkuszy Google wyświetla wybrany arkusz, chyba że należy on do innego arkusza.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var firstSheet = spreadsheet.getSheets()[0];
var secondSheet = spreadsheet.getSheets()[1];
// Set the first sheet as the active sheet and select the range D4:F4.
spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate();

// Switch to the second sheet to do some work.
spreadsheet.setActiveSheet(secondSheet);
// Switch back to first sheet, and restore its selection.
spreadsheet.setActiveSheet(firstSheet, true);

// The selection of first sheet is restored, and it logs D4:F4
var range = spreadsheet.getActiveSheet().getSelection().getActiveRange();
Logger.log(range.getA1Notation());

Parametry

Nazwa	Typ	Opis
`sheet`	`Sheet`	Nowy aktywny arkusz.
`restoreSelection`	`Boolean`	Tf `true`, najnowszy wybór nowego aktywnego arkusza zostanie ponownie wybrany, gdy nowy arkusz stanie się aktywny. Jeśli `false`, nowy arkusz stanie się aktywny bez zmiany bieżącego.

Zwróć

Sheet – nowy aktywny arkusz.

Upoważnienie

Skrypty, które używają 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(columnPosition, width)`

Ustawia szerokość danej kolumny w pikselach.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Sets the first column to a width of 200 pixels
sheet.setColumnWidth(1, 200);

Parametry

Nazwa	Typ	Opis
`columnPosition`	`Integer`	Pozycja kolumny do ustawienia.
`width`	`Integer`	Szerokość w pikselach, którą chcesz ustawić.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`setCurrentCell(cell)`

Ustawia określoną komórkę jako current cell.

Jeśli określona komórka znajduje się w zakresie, który został już wybrany, staje się on aktywny, wraz z bieżącą komórką.

Jeśli określonej komórki nie ma w wybranym zakresie, wszystkie obecne wartości są usuwane, a komórka staje się bieżącą i aktywnym zakresem.

Uwaga: podany Range musi składać się z jednej komórki. W przeciwnym razie wskazuje wyjątek.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var cell = sheet.getRange('B5');
sheet.setCurrentCell(cell);

var selection = sheet.getSelection();
// Current cell: B5
var currentCell = selection.getCurrentCell();

Parametry

Nazwa	Typ	Opis
`cell`	`Range`	Komórka, która ma być ustawiona jako bieżąca komórka.

Zwróć

Range – nowo ustawiona komórka,

Upoważnienie

Skrypty, które używają 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

`setFrozenColumns(columns)`

Powoduje zablokowanie podanej liczby kolumn. Jeśli zero, żadne kolumny nie są zablokowane.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Freezes the first column
sheet.setFrozenColumns(1);

Parametry

Nazwa	Typ	Opis
`columns`	`Integer`	Liczba kolumn do zablokowania.

Upoważnienie

Skrypty, które używają 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

`setFrozenRows(rows)`

Powoduje zablokowanie podanej liczby wierszy. Jeśli zero, żadne wiersze nie są zablokowane.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Freezes the first row
sheet.setFrozenRows(1);

Parametry

Nazwa	Typ	Opis
`rows`	`Integer`	Liczba wierszy do zablokowania.

Upoważnienie

Skrypty, które używają 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

`setIterativeCalculationConvergenceThreshold(minThreshold)`

Ustawia minimalną wartość progową do obliczeń iteracyjnych. Gdy wyniki kolejnych obliczeń różnią się od tej wartości, obliczenia iteracyjne zostają zatrzymane. Ta wartość nie może być ujemna i jej domyślna wartość to 0, 05.

Parametry

Nazwa	Typ	Opis
`minThreshold`	`Number`	Minimalny próg konwersji (nie może być liczbą ujemną).

Zwróć

Spreadsheet – ten arkusz kalkulacyjny na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają 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

`setIterativeCalculationEnabled(isEnabled)`

Określa, czy w tym arkuszu kalkulacyjnym włączone są obliczenia iteracyjne. Jeśli po włączeniu obliczeń nie została wcześniej ustawiona maksymalna liczba cykli obliczeniowych i próg konwersji, ich domyślna wartość to odpowiednio 50 i 0,05. Jeśli któraś z tych opcji została ustawiona wcześniej, zachowają poprzednie wartości.

Parametry

Nazwa	Typ	Opis
`isEnabled`	`Boolean`	`true`, jeśli powinny być włączone obliczenia iteracyjne. W przeciwnym razie `false`.

Zwróć

Spreadsheet – ten arkusz kalkulacyjny na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają 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

`setMaxIterativeCalculationCycles(maxIterations)`

Określa maksymalną liczbę iteracji obliczeń, które powinny być wykonane podczas obliczeń iteracyjnych. Ta wartość musi mieścić się w przedziale od 1 do 10 000 (włącznie) i domyślnie wynosi 50.

Parametry

Nazwa	Typ	Opis
`maxIterations`	`Integer`	Maksymalna liczba iteracji obliczeń (między 1 a 10 000).

Zwróć

Spreadsheet – ten arkusz kalkulacyjny na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają 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

`setNamedRange(name, range)`

Określa zakres.

// The code below creates a new named range "TaxRates" in the active spreadsheet
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange("TaxRates", SpreadsheetApp.getActiveRange());

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa zakresu.
`range`	`Range`	Specyfikacja zakresu.

Upoważnienie

Skrypty, które używają 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

`setRecalculationInterval(recalculationInterval)`

Określa, jak często ten arkusz kalkulacyjny ma być przeliczany.

Parametry

Nazwa	Typ	Opis
`recalculationInterval`	`RecalculationInterval`	Nowy interwał przeliczania.

Zwróć

Spreadsheet – ten arkusz kalkulacyjny na potrzeby łańcucha.

Upoważnienie

Skrypty, które używają 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

`setRowHeight(rowPosition, height)`

Ustawia wysokość wiersza w pikselach. Domyślnie wiersze rozwijają się, aby zmieścić zawartość komórki. Jeśli chcesz wymusić wiersz do określonej wysokości, użyj Sheet.setRowHeightsForced(startRow, numRows, height).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Sets the first row to a height of 200 pixels
sheet.setRowHeight(1, 200);

Parametry

Nazwa	Typ	Opis
`rowPosition`	`Integer`	Pozycja wiersza, którą chcesz zmienić.
`height`	`Integer`	Wysokość w pikselach, którą chcesz ustawić.

Zwróć

Sheet – arkusz przydatny do łańcucha metod.

Upoważnienie

Skrypty, które używają 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

`setSpreadsheetLocale(locale)`

Ustawia język arkusza kalkulacyjnego.

Parametry

Nazwa	Typ	Opis
`locale`	`String`	Kod języka, którego należy użyć (na przykład „en”, „fr” lub „en_US”).

Upoważnienie

Skrypty, które używają 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

`setSpreadsheetTheme(theme)`

Ustawia motyw arkusza kalkulacyjnego.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// The code below sets the second predefined theme as the current theme of the spreadsheet.
var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes();
spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);

Parametry

Nazwa	Typ	Opis
`theme`	`SpreadsheetTheme`	Motyw do zastosowania.

Zwróć

SpreadsheetTheme – nowy bieżący motyw.

Upoważnienie

Skrypty, które używają 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

`setSpreadsheetTimeZone(timezone)`

Ustawia strefę czasową arkusza kalkulacyjnego.

Parametry

Nazwa	Typ	Opis
`timezone`	`String`	Strefa czasowa podana w formacie „długim” (np. „Ameryka/Nowy_Jork” w formacie Joda.org).

Upoważnienie

Skrypty, które używają 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

`show(userInterface)`

Wyświetla komponent interfejsu użytkownika w oknie wyśrodkowanym w widocznym obszarze przeglądarki użytkownika. Wykonanie skryptu po stronie serwera nie jest zawieszone. Aby komunikować się po stronie serwera, komponent interfejsu użytkownika musi wywoływać asynchroniczne wywołania zwrotne dla skryptu po stronie serwera.

Jeśli skrypt po stronie serwera wyświetlał poprzednio okno, które nie zostało jeszcze zamknięte, dotychczasowe okno zostanie zastąpione nowym interfejsem.

Ten fragment kodu zawiera prostą aplikację HtmlService w oknie dialogowym o podanym tytule, wysokości i szerokości:

var htmlApp = HtmlService
    .createHtmlOutput('<p>A change of speed, a change of style...</p>')
    .setTitle('My HtmlService Application')
    .setWidth(250)
    .setHeight(300);

SpreadsheetApp.getActiveSpreadsheet().show(htmlApp);

// The script resumes execution immediately after showing the dialog.

Parametry

Nazwa	Typ	Opis
`userInterface`	`Object`	`HtmlOutput`

Upoważnienie

Skrypty, które używają tej metody, wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/script.container.ui

`sort(columnPosition)`

Sortuje arkusz według kolumny rosnąco.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Sorts the sheet by the first column, ascending
sheet.sort(1);

Parametry

Nazwa	Typ	Opis
`columnPosition`	`Integer`	Kolumna do sortowania.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`sort(columnPosition, ascending)`

Sortuje arkusz według kolumny. Pobiera parametr, który określa rosnącą lub malejącą wartość.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Sorts the sheet by the first column, descending
sheet.sort(1, false);

Parametry

Nazwa	Typ	Opis
`columnPosition`	`Integer`	Kolumna do sortowania.
`ascending`	`Boolean`	`true` – sortowanie rosnące, `false` – sortowanie malejące.

Zwróć

Sheet – arkusz przydatny do łańcucha metod

Upoważnienie

Skrypty, które używają 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

`toast(msg)`

Pokazuje wyskakujące okienko w prawym dolnym rogu arkusza kalkulacyjnego z tą wiadomością.

// Show a popup with the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started');

Parametry

Nazwa	Typ	Opis
`msg`	`String`	Komunikat, który ma się pojawić w wyświetleniu.

Upoważnienie

Skrypty, które używają 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

`toast(msg, title)`

W prawym dolnym rogu arkusza kalkulacyjnego wyświetla wyskakujące okienko z określoną wiadomością i tytułem.

// Show a popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');

Parametry

Nazwa	Typ	Opis
`msg`	`String`	Komunikat, który ma się pojawić w wyświetleniu.
`title`	`String`	Opcjonalny tytuł tosty.

Upoważnienie

Skrypty, które używają 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

`toast(msg, title, timeoutSeconds)`

W prawym dolnym rogu arkusza kalkulacyjnego wyświetla wyskakujące okienko z określonym tytułem i wiadomością, które jest widoczne przez określony czas.

// Show a 3-second popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);

Parametry

Nazwa	Typ	Opis
`msg`	`String`	Komunikat, który ma się pojawić w wyświetleniu.
`title`	`String`	Opcjonalny tytuł tosty.
`timeoutSeconds`	`Number`	Limit czasu w sekundach. Jeśli to ustawienie ma wartość `null`, domyślnie wyświetla się 5 sekund. Jeśli jest ujemna, powiadomienie pozostaje widoczne, dopóki go nie odrzucisz.

Upoważnienie

Skrypty, które używają 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

`unhideColumn(column)`

Odkryj kolumnę w podanym zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This unhides the first column if it was previously hidden
var range = sheet.getRange("A1");
sheet.unhideColumn(range);

Parametry

Nazwa	Typ	Opis
`column`	`Range`	Zakres do ukrycia (jeśli jest ukryty).

Upoważnienie

Skrypty, które używają 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

`unhideRow(row)`

Odkryje wiersz w podanym zakresie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This unhides the first row if it was previously hidden
var range = sheet.getRange("A1");
sheet.unhideRow(range);

Parametry

Nazwa	Typ	Opis
`row`	`Range`	Zakres do ukrycia (jeśli jest ukryty).

Upoważnienie

Skrypty, które używają 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

`updateMenu(name, subMenus)`

Aktualizuje menu dodane przez użytkownika addMenu(name, subMenus). Działa dokładnie tak samo jak addMenu(name, subMenus).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var menuEntries = [];
menuEntries.push({name: "Lone Menu Entry", functionName: "function1"});
ss.updateMenu("addMenuExample", menuEntries);

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nazwa menu do zaktualizowania.
`subMenus`	`Object[]`	Tablica map JavaScript z parametrami `name` i `functionName`. Możesz użyć funkcji z dołączonych bibliotek, takich jak `Library.libFunction1`.

Upoważnienie

Skrypty, które używają 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 arkusza kalkulacyjnego zostaną zakończone i przekroczy limit czasu po upływie określonej liczby sekund. Zgłasza wyjątek, jeśli wykonanie nie zostanie ukończone w czasie przekroczenia limitu czasu, ale nie spowoduje anulowania uruchomień danych.

Parametry

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

Upoważnienie

Skrypty, które używają 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

Metody wycofane

`getSheetProtection()`

Wycofane. W przypadku arkuszy kalkulacyjnych utworzonych w nowszej wersji Arkuszy Google użyj funkcji Sheet.getProtections(type), która zwraca bardziej zaawansowaną klasę Protection. Mimo że ta metoda została wycofana, nadal jest dostępna pod kątem zgodności ze starszą wersją Arkuszy

Zwraca instancję PageProtection z opisem uprawnień do bieżącego arkusza.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var permissions = sheet.getSheetProtection();

permissions.setProtected(true);
permissions.addUser("user@example.com");

// Logs the users that have access to edit this sheet. Note that this
// is different from access to the entire spreadsheet - getUsers()
// only returns users if permissions.isProtected() is set to true.
var users = permissions.getUsers();
Logger.log(users);

Zwróć

PageProtection – obiekt opisujący uprawnienia dostępu do arkusza;

Upoważnienie

Skrypty, które używają 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

`isAnonymousView()`

Wycofane. Od stycznia 2014 roku ta funkcja jest wycofana i nie jest dostępna w nowej wersji Arkuszy Google.

Wskazuje, czy dokument umożliwia anonimowe wyświetlanie. Ponieważ nowa wersja Arkuszy Google nie jest już obsługiwana, użyj zamiast nich właściwości File.getSharingAccess() i File.getSharingPermission().

// Determine if the document allows anonymous viewing via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());
var access = file.getSharingAccess();
var permission = file.getSharingPermission();
var isAnonymousAccess =
    access == DriveApp.Access.ANYONE || access == DriveApp.Access.ANYONE_WITH_LINK;
var isAnonymousEdit = isAnonymousAccess && permission != DriveApp.Permission.NONE;

Zwróć

Boolean – true, jeśli dokument zezwala na wyświetlanie anonimowe, w przeciwnym razie ma wartość false.

Upoważnienie

Skrypty, które używają 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

Zobacz też

Usługa Dysku

`isAnonymousWrite()`

Wycofane. Od stycznia 2014 roku ta funkcja jest wycofana i nie jest dostępna w nowej wersji Arkuszy Google.

Wskazuje, czy dokument umożliwia edytowanie przez anonimowych użytkowników. Ponieważ nowa wersja Arkuszy Google nie jest już obsługiwana, zamiast tego użyj File.getSharingAccess() i File.getSharingPermission().

// Determine if the document allow anonymous edits via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());
var access = file.getSharingAccess();
var permission = file.getSharingPermission();
var isAnonymousAccess =
    access == DriveApp.Access.ANYONE || access == DriveApp.Access.ANYONE_WITH_LINK;
var isAnonymousEdit = isAnonymousAccess && permission == DriveApp.Permission.EDIT;

Zwróć

Boolean – true, jeśli dokument umożliwia anonimowe edytowanie, w innym przypadku false.

Upoważnienie

Skrypty, które używają 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

Zobacz też

Usługa Dysku

`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`

Wycofane. Od stycznia 2014 roku ta funkcja jest wycofana i nie jest dostępna w nowej wersji Arkuszy Google.

Ustawia zasady dokumentu dotyczące anonimowego odczytu i zapisu. Ponieważ nowa wersja Arkuszy Google nie jest już obsługiwana, zamiast tego użyj File.setSharing(accessType, permissionType).

// Set the document's policy on anonymous reading and writing via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());

// Set anonymous read.
file.setSharing(DriveApi.Access.ANYONE, DriveApi.Permission.VIEW);

// Set anonymous write.
file.setSharing(DriveApi.Access.ANYONE, DriveApi.Permission.EDIT);

// Disable anonymous access.
file.setSharing(DriveApi.Access.PRIVATE, file.getSharingPermission());

Parametry

Nazwa	Typ	Opis
`anonymousReadAllowed`	`Boolean`	`true`, aby zezwalać na anonimowe odczyty. W przeciwnym razie `false`.
`anonymousWriteAllowed`	`Boolean`	`true`, aby zezwalać na anonimowe odczyty. W przeciwnym razie `false`.

Upoważnienie

Skrypty, które używają 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

Zobacz też

isAnonymousView()
isAnonymousWrite()
Usługa Dysku

`setSheetProtection(permissions)`

Wycofane. W przypadku arkuszy kalkulacyjnych utworzonych w nowszej wersji Arkuszy Google użyj funkcji Sheet.protect(), która zwraca bardziej zaawansowaną klasę Protection. Mimo że ta metoda została wycofana, nadal jest dostępna pod kątem zgodności ze starszą wersją Arkuszy

Ustawia uprawnienia dla bieżącego arkusza.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var permissions = sheet.getSheetProtection();

// This copies the permissions on the first sheet to the second sheet
var sheetToClonePermissionsTo = ss.getSheets()[1];
sheetToClonePermissionsTo.setSheetProtection(permissions);

Parametry

Nazwa	Typ	Opis
`permissions`	`PageProtection`	Obiekt uprawnień dostępu, który ma zostać ustawiony w tym arkuszu.

Upoważnienie

Skrypty, które używają 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