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

Class Sheet

Dostęp do arkuszy kalkulacyjnych i ich modyfikowanie. Typowe operacje to zmiana nazwy arkusza i uzyskiwanie dostępu do obiektów zakresu z arkusza.

Metody

Metoda	Zwracany typ	Krótki opis
`activate()`	`Sheet`	Aktywuje ten arkusz.
`addDeveloperMetadata(key)`	`Sheet`	Dodaje do arkusza metadane dewelopera z określonym kluczem.
`addDeveloperMetadata(key, visibility)`	`Sheet`	Dodaje do arkusza metadane dewelopera z określonym kluczem i widocznością.
`addDeveloperMetadata(key, value)`	`Sheet`	Dodaje do arkusza metadane dewelopera z określonym kluczem i wartością.
`addDeveloperMetadata(key, value, visibility)`	`Sheet`	Dodaje do arkusza metadane dewelopera z określonym kluczem, wartością i widocznością.
`appendRow(rowContents)`	`Sheet`	Dodaje wiersz na dole bieżącego regionu danych w arkuszu.
`asDataSourceSheet()`	`DataSourceSheet`	Zwraca arkusz jako `DataSourceSheet`, jeśli jest typu `SheetType.DATASOURCE`, lub `null` w innym przypadku.
`autoResizeColumn(columnPosition)`	`Sheet`	Ustawia szerokość danej kolumny, aby pasowała do jej zawartości.
`autoResizeColumns(startColumn, numColumns)`	`Sheet`	Ustawia szerokość wszystkich kolumn, począwszy od podanej pozycji kolumny, aby dopasować się do ich zawartości.
`autoResizeRows(startRow, numRows)`	`Sheet`	Ustawia wysokość wszystkich wierszy, począwszy od podanej pozycji wiersza, aby dopasować się do ich zawartości.
`clear()`	`Sheet`	Czyści arkusz z treścią i informacjami o formatowaniu.
`clear(options)`	`Sheet`	Czyści arkusz treści i/lub formatu zgodnie z określonymi opcjami zaawansowanymi.
`clearConditionalFormatRules()`	`void`	Usuwa z arkusza wszystkie reguły formatowania warunkowego.
`clearContents()`	`Sheet`	Czyści arkusz treści przy zachowaniu formatowania informacji.
`clearFormats()`	`Sheet`	Czyści arkusz formatowania przy zachowaniu treści.
`clearNotes()`	`Sheet`	Usuwa wszystkie notatki w arkuszu.
`collapseAllColumnGroups()`	`Sheet`	Zwija wszystkie grupy kolumn w arkuszu.
`collapseAllRowGroups()`	`Sheet`	Zwija wszystkie grupy wierszy w arkuszu.
`copyTo(spreadsheet)`	`Sheet`	Kopiuje arkusz do wybranego arkusza kalkulacyjnego, który może być tym samym arkuszem kalkulacyjnym co arkusz źródłowy.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Zwraca `DeveloperMetadataFinder` do wyszukiwania metadanych dewelopera w zakresie tego arkusza.
`createTextFinder(findText)`	`TextFinder`	Tworzy w arkuszu wyszukiwarkę tekstu, która może znajdować i zastępować tekst w arkuszu.
`deleteColumn(columnPosition)`	`Sheet`	Usuwa kolumnę znajdującą się w danym miejscu.
`deleteColumns(columnPosition, howMany)`	`void`	Usuwa liczbę kolumn, zaczynając od podanej pozycji kolumny.
`deleteRow(rowPosition)`	`Sheet`	Usuwa wiersz na podanej pozycji.
`deleteRows(rowPosition, howMany)`	`void`	Usuwa wiele wierszy, zaczynając od określonej pozycji wiersza.
`expandAllColumnGroups()`	`Sheet`	Rozwija wszystkie grupy kolumn w arkuszu.
`expandAllRowGroups()`	`Sheet`	Rozwija wszystkie grupy wierszy w arkuszu.
`expandColumnGroupsUpToDepth(groupDepth)`	`Sheet`	Rozwija wszystkie grupy kolumn do podanej głębokości i zwija wszystkie pozostałe.
`expandRowGroupsUpToDepth(groupDepth)`	`Sheet`	Rozwija wszystkie grupy wierszy do podanej głębokości i zwija wszystkie pozostałe.
`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 funkcję `null`, jeśli nie ma aktywnych zakresów.
`getBandings()`	`Banding[]`	Zwraca wszystkie pasma w tym arkuszu.
`getCharts()`	`EmbeddedChart[]`	Zwraca tablicę wykresów z tego arkusza.
`getColumnGroup(columnIndex, groupDepth)`	`Group`	Zwraca grupę kolumn o podanym indeksie i głębokości grupy.
`getColumnGroupControlPosition()`	`GroupControlTogglePosition`	Zwraca wartość `GroupControlTogglePosition` dla wszystkich grup kolumn w arkuszu.
`getColumnGroupDepth(columnIndex)`	`Integer`	Zwraca głębokość grupy w kolumnie dla podanego indeksu.
`getColumnWidth(columnPosition)`	`Integer`	Pobiera szerokość danej kolumny w pikselach.
`getConditionalFormatRules()`	`ConditionalFormatRule[]`	Pobierz wszystkie reguły formatowania warunkowego w tym arkuszu.
`getCurrentCell()`	`Range`	Zwraca bieżącą komórkę w aktywnym arkuszu lub `null`, jeśli nie ma bieżącej komórki.
`getDataRange()`	`Range`	Zwraca wartość `Range` odpowiadającą wymiarowi, w którym znajdują się dane.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Pobiera wszystkie formuły źródeł danych.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Pobiera wszystkie tabele przestawne źródła danych.
`getDataSourceTables()`	`DataSourceTable[]`	Pobiera wszystkie tabele źródeł danych.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Pobierz wszystkie metadane dewelopera powiązane z tym arkuszem.
`getDrawings()`	`Drawing[]`	Zwraca tablicę rysunków w arkuszu.
`getFilter()`	`Filter`	Zwraca filtr w tym arkuszu lub `null`, jeśli nie ma filtra.
`getFormUrl()`	`String`	Zwraca adres URL formularza, który wysyła odpowiedzi do tego arkusza, lub `null`, jeśli arkusz nie ma powiązanego formularza.
`getFrozenColumns()`	`Integer`	Zwraca liczbę zablokowanych kolumn.
`getFrozenRows()`	`Integer`	Zwraca liczbę zablokowanych wierszy.
`getImages()`	`OverGridImage[]`	Zwraca wszystkie obrazy w siatce.
`getIndex()`	`Integer`	Pobiera pozycję arkusza w nadrzędnym arkuszu kalkulacyjnym.
`getLastColumn()`	`Integer`	Zwraca pozycję ostatniej kolumny, która zawiera treść.
`getLastRow()`	`Integer`	Zwraca pozycję ostatniego wiersza zawierającego treść.
`getMaxColumns()`	`Integer`	Zwraca aktualną liczbę kolumn w arkuszu niezależnie od treści.
`getMaxRows()`	`Integer`	Zwraca aktualną liczbę wierszy w arkuszu niezależnie od treści.
`getName()`	`String`	Zwraca nazwę arkusza.
`getNamedRanges()`	`NamedRange[]`	Pobiera wszystkie zakresy nazwane z tego arkusza.
`getParent()`	`Spreadsheet`	Zwraca wartość `Spreadsheet` zawierającą ten arkusz.
`getPivotTables()`	`PivotTable[]`	Zwraca wszystkie tabele przestawne w tym arkuszu.
`getProtections(type)`	`Protection[]`	Pobiera tablicę obiektów reprezentującą wszystkie chronione zakresy w arkuszu lub tablicę jednoelementową reprezentującą ochronę w samym arkuszu.
`getRange(row, column)`	`Range`	Zwraca zakres z lewą górną komórką o podanych współrzędnych.
`getRange(row, column, numRows)`	`Range`	Zwraca zakres z lewą górną komórką o podanych współrzędnych i z podaną liczbą wierszy.
`getRange(row, column, numRows, numColumns)`	`Range`	Zwraca zakres z lewą górną komórką o podanych współrzędnych dla podanej liczby wierszy i kolumn.
`getRange(a1Notation)`	`Range`	Zwraca zakres określony w notacji A1 lub w notacji R1C1.
`getRangeList(a1Notations)`	`RangeList`	Zwraca kolekcję `RangeList` reprezentującą zakresy w tym samym arkuszu określoną za pomocą niepustej listy notacji A1 lub notacji R1C1.
`getRowGroup(rowIndex, groupDepth)`	`Group`	Zwraca grupę wierszy o podanym indeksie i głębokości grupy.
`getRowGroupControlPosition()`	`GroupControlTogglePosition`	Zwraca wartość `GroupControlTogglePosition` w przypadku wszystkich grup wierszy w arkuszu.
`getRowGroupDepth(rowIndex)`	`Integer`	Zwraca głębokość grupy wiersza w danym indeksie.
`getRowHeight(rowPosition)`	`Integer`	Pobiera wysokość danego wiersza w pikselach.
`getSelection()`	`Selection`	Zwraca bieżącą wartość `Selection` z arkusza kalkulacyjnego.
`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, zaczynając od podanych współrzędnych.
`getSlicers()`	`Slicer[]`	Zwraca tablicę fragmentatorów w arkuszu.
`getTabColorObject()`	`Color`	Pobiera kolor karty arkusza lub `null`, jeśli karta arkusza nie ma koloru.
`getType()`	`SheetType`	Zwraca typ arkusza.
`hasHiddenGridlines()`	`Boolean`	Zwraca wartość `true`, jeśli linie siatki w arkuszu są ukryte. W przeciwnym razie zwraca wartość `false`.
`hideColumn(column)`	`void`	Ukrywa kolumnę lub kolumny w danym zakresie.
`hideColumns(columnIndex)`	`void`	Ukrywa jedną kolumnę w danym indeksie.
`hideColumns(columnIndex, numColumns)`	`void`	Ukrywa co najmniej 1 kolumnę z rzędu, zaczynając od danego indeksu.
`hideRow(row)`	`void`	Ukrywa wiersze w danym zakresie.
`hideRows(rowIndex)`	`void`	Ukrywa wiersz o podanym indeksie.
`hideRows(rowIndex, numRows)`	`void`	Ukrywa co najmniej 1 wiersz z rzędu, zaczynając od danego indeksu.
`hideSheet()`	`Sheet`	Ukrywa ten arkusz.
`insertChart(chart)`	`void`	Dodaje nowy wykres do tego arkusza.
`insertColumnAfter(afterPosition)`	`Sheet`	Wstawia kolumnę po podanej pozycji kolumny.
`insertColumnBefore(beforePosition)`	`Sheet`	Wstawia kolumnę przed podaną pozycją kolumny.
`insertColumns(columnIndex)`	`void`	Wstawia pustą kolumnę w arkuszu w określonej lokalizacji.
`insertColumns(columnIndex, numColumns)`	`void`	Wstawia jedną lub kilka następujących po sobie pustych kolumn w arkuszu, zaczynając od określonej lokalizacji.
`insertColumnsAfter(afterPosition, howMany)`	`Sheet`	Wstawia podaną liczbę kolumn po podanej pozycji kolumny.
`insertColumnsBefore(beforePosition, howMany)`	`Sheet`	Wstawia pewną liczbę kolumn przed podaną pozycją kolumny.
`insertImage(blobSource, column, row)`	`OverGridImage`	Wstawia `BlobSource` jako obraz w dokumencie w danym wierszu i kolumnie.
`insertImage(blobSource, column, row, offsetX, offsetY)`	`OverGridImage`	Wstawia `BlobSource` jako obraz w dokumencie w określonym wierszu i kolumnie z przesunięciem piksela.
`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 kolumnie z odsunięciem piksela.
`insertRowAfter(afterPosition)`	`Sheet`	Wstawia wiersz po podanej pozycji wiersza.
`insertRowBefore(beforePosition)`	`Sheet`	Wstawia wiersz przed podaną pozycją wiersza.
`insertRows(rowIndex)`	`void`	Wstawia pusty wiersz w arkuszu w określonej lokalizacji.
`insertRows(rowIndex, numRows)`	`void`	Wstawia jeden lub kilka następujących po sobie pustych wierszy w arkuszu, zaczynając od określonej lokalizacji.
`insertRowsAfter(afterPosition, howMany)`	`Sheet`	Wstawia liczbę wierszy po podanej pozycji wiersza.
`insertRowsBefore(beforePosition, howMany)`	`Sheet`	Wstawia pewną liczbę wierszy przed podaną pozycją wiersza.
`insertSlicer(range, anchorRowPos, anchorColPos)`	`Slicer`	Dodaje nowy fragmentator do tego arkusza.
`insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)`	`Slicer`	Dodaje nowy fragmentator do tego arkusza.
`isColumnHiddenByUser(columnPosition)`	`Boolean`	Zwraca, czy dana kolumna jest ukryta przez użytkownika.
`isRightToLeft()`	`Boolean`	Zwraca wartość `true`, jeśli układ arkusza jest ułożony od prawej do lewej.
`isRowHiddenByFilter(rowPosition)`	`Boolean`	Zwraca, czy dany wiersz został ukryty przez filtr (a nie przez widok filtra).
`isRowHiddenByUser(rowPosition)`	`Boolean`	Zwraca, czy dany wiersz jest ukryty przez użytkownika.
`isSheetHidden()`	`Boolean`	Zwraca wartość `true`, jeśli arkusz jest obecnie ukryty.
`moveColumns(columnSpec, destinationIndex)`	`void`	Przenosi kolumny zaznaczone w danym zakresie do pozycji wskazanej w kolumnie `destinationIndex`.
`moveRows(rowSpec, destinationIndex)`	`void`	Przenosi wiersze zaznaczone przez podany zakres do pozycji wskazanej przez wartość `destinationIndex`.
`newChart()`	`EmbeddedChartBuilder`	Zwraca narzędzie do utworzenia nowego wykresu w tym arkuszu.
`protect()`	`Protection`	Tworzy obiekt, który może chronić przed edytowaniem arkusza – nie dotyczy to użytkowników z odpowiednimi uprawnieniami.
`removeChart(chart)`	`void`	Usuwa wykres z arkusza nadrzędnego.
`setActiveRange(range)`	`Range`	Ustawia określony zakres jako `active range` w aktywnym arkuszu, a lewa górna komórka w zakresie to `current cell`.
`setActiveRangeList(rangeList)`	`RangeList`	Ustawia określoną listę zakresów jako `active ranges` w aktywnym arkuszu.
`setActiveSelection(range)`	`Range`	Określa aktywny region zaznaczenia w tym arkuszu.
`setActiveSelection(a1Notation)`	`Range`	Ustawia aktywne zaznaczenie zgodnie z zapisem A1 lub notacją R1C1.
`setColumnGroupControlPosition(position)`	`Sheet`	Określa pozycję przełącznika kontroli grupy kolumn w arkuszu.
`setColumnWidth(columnPosition, width)`	`Sheet`	Ustawia szerokość danej kolumny w pikselach.
`setColumnWidths(startColumn, numColumns, width)`	`Sheet`	Ustawia szerokość danych kolumn w pikselach.
`setConditionalFormatRules(rules)`	`void`	Zastępuje wszystkie istniejące reguły formatowania warunkowego w arkuszu regułami wejściowymi.
`setCurrentCell(cell)`	`Range`	Ustawia określoną komórkę jako `current cell`.
`setFrozenColumns(columns)`	`void`	Blokuje podaną liczbę kolumn.
`setFrozenRows(rows)`	`void`	Blokuje podaną liczbę wierszy.
`setHiddenGridlines(hideGridlines)`	`Sheet`	Ukrywa lub ujawnia linie siatki w arkuszu.
`setName(name)`	`Sheet`	Określa nazwę arkusza.
`setRightToLeft(rightToLeft)`	`Sheet`	Ustawia lub wyłącza układ arkusza od prawej do lewej.
`setRowGroupControlPosition(position)`	`Sheet`	Określa pozycję przełącznika kontroli grupy wierszy w arkuszu.
`setRowHeight(rowPosition, height)`	`Sheet`	Ustawia wysokość wiersza danego wiersza w pikselach.
`setRowHeights(startRow, numRows, height)`	`Sheet`	Ustawia wysokość danych wierszy w pikselach.
`setRowHeightsForced(startRow, numRows, height)`	`Sheet`	Ustawia wysokość danych wierszy w pikselach.
`setTabColor(color)`	`Sheet`	Ustawia kolor karty arkusza.
`setTabColorObject(color)`	`Sheet`	Ustawia kolor karty arkusza.
`showColumns(columnIndex)`	`void`	Odkrywa kolumnę w danym indeksie.
`showColumns(columnIndex, numColumns)`	`void`	Odkrywa co najmniej 1 kolumnę z rzędu, zaczynając od danego indeksu.
`showRows(rowIndex)`	`void`	Odkrywa wiersz w danym indeksie.
`showRows(rowIndex, numRows)`	`void`	Pokazuje co najmniej 1 wiersz z rzędu, zaczynając od danego indeksu.
`showSheet()`	`Sheet`	Sprawia, że arkusz jest widoczny.
`sort(columnPosition)`	`Sheet`	Sortuje arkusz według kolumny rosnąco.
`sort(columnPosition, ascending)`	`Sheet`	Sortuje arkusz według kolumny.
`unhideColumn(column)`	`void`	Odkrywa kolumnę w danym zakresie.
`unhideRow(row)`	`void`	Odkrywa wiersz w podanym zakresie.
`updateChart(chart)`	`void`	Aktualizuje wykres w tym arkuszu.

Wycofane metody

Metoda	Zwracany typ	Krótki opis
`getSheetProtection()`	`PageProtection`	Zwraca wystąpienie `PageProtection` opisujące uprawnienia bieżącego arkusza.
`getTabColor()`	`String`	Pobiera kolor karty arkusza lub `null`, jeśli karta arkusza nie ma koloru.
`setSheetProtection(permissions)`	`void`	Ustawia uprawnienia dla bieżącego arkusza.

Szczegółowa dokumentacja

`activate()`

Aktywuje ten arkusz. Nie zmienia samego arkusza, a jedynie znaczenie aktywnego arkusza z poziomu elementu nadrzędnego.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.activate();

Powroty

Sheet – nowo aktywny arkusz.

`addDeveloperMetadata(key)`

Dodaje do arkusza metadane dewelopera z określonym kluczem.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'NAME' to the developer metadata for the sheet.
sheet.addDeveloperMetadata('NAME');

// Gets the updated metadata info and logs it to the console.
console.log(sheet.getDeveloperMetadata()[0].getKey());

Parametry

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

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, visibility)`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'NAME' and sets the developer metadata visibility to PROJECT
// for the sheet.
sheet.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = sheet.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getVisibility().toString());

Parametry

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

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, value)`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'COMPANY' with the value 'TECH' to the developer metadata for the sheet.
sheet.addDeveloperMetadata('COMPANY', 'TECH');

// Gets the updated metadata info and logs it to the console.
const developerMetaData = sheet.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());

Parametry

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

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, value, visibility)`

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

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'COMPANY' with the value 'TECH' to the developer metadata and sets the
// visibility to DOCUMENT for the sheet.
sheet.addDeveloperMetadata(
  'COMPANY',
  'TECH',
  SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = sheet.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

Parametry

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

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`appendRow(rowContents)`

Dodaje wiersz na dole bieżącego regionu danych w arkuszu. Jeśli zawartość komórki zaczyna się od ciągu =, jest ona interpretowana jako formuła.

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 do wstawienia po ostatnim wierszu w arkuszu.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`asDataSourceSheet()`

Zwraca arkusz jako DataSourceSheet, jeśli jest typu SheetType.DATASOURCE, lub null w innym przypadku.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the data source sheet value if the sheet is of type
// SpreadsheetApp.SheetType.DATASOURCE, otherwise this returns a null value.
const dataSourceSheet = sheet.asDataSourceSheet();

// Gets the data source sheet value and logs it to the console.
console.log(dataSourceSheet);
console.log(sheet.getType().toString());

Powroty

DataSourceSheet – arkusz źródła danych.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`autoResizeColumn(columnPosition)`

Ustawia szerokość danej kolumny, aby pasowała 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 ma zostać zmieniony.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`autoResizeColumns(startColumn, numColumns)`

Ustawia szerokość wszystkich kolumn, począwszy od podanej pozycji kolumny, aby dopasować się do ich zawartości.

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

// Sets the first 15 columns to a width that fits their text.
sheet.autoResizeColumns(1, 15);

Parametry

Nazwa	Typ	Opis
`startColumn`	`Integer`	Kolumna początkowa, której rozmiar ma być automatycznie zmieniany.
`numColumns`	`Integer`	Liczba kolumn do automatycznego zmiany rozmiaru.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`autoResizeRows(startRow, numRows)`

Ustawia wysokość wszystkich wierszy, począwszy od podanej pozycji wiersza, aby dopasować się do ich zawartości.

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

// Sets the first 15 rows to a height that fits their text.
sheet.autoResizeRows(1, 15);

Parametry

Nazwa	Typ	Opis
`startRow`	`Integer`	Wiersz początkowy do automatycznego zmieniania rozmiaru.
`numRows`	`Integer`	Liczba wierszy do automatycznego zmiany rozmiaru.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clear()`

Czyści arkusz z treścią i informacjami o formatowaniu.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.clear();

Powroty

Sheet – wyczyszczony arkusz.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clear(options)`

Czyści arkusz treści i/lub formatu zgodnie z określonymi opcjami zaawansowanymi.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.clear({ formatOnly: true, contentsOnly: true });

Parametry

Nazwa	Typ	Opis
`options`	`Object`	Mapa JavaScript zawierająca wymienione poniżej opcje zaawansowane.

Parametry zaawansowane

Nazwa	Typ	Opis
`contentsOnly`	`Boolean`	Czy usunąć treść.
`formatOnly`	`Boolean`	Określa, czy format ma zostać usunięty.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearConditionalFormatRules()`

Usuwa z arkusza wszystkie reguły formatowania warunkowego. Odpowiednik wywołania funkcji setConditionalFormatRules(rules) z pustą tablicą jako dane wejściowe.

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearContents()`

Czyści arkusz treści przy zachowaniu formatowania informacji.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.clearContents();

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearFormats()`

Czyści arkusz formatowania przy zachowaniu treści.

Formatowanie danych odnosi się do sposobu formatowania danych, który jest dozwolony w menu „Format”, (np. pogrubienie, kursywa, formatowanie warunkowe), a nie szerokość lub wysokość komórek.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.clearFormats();

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`clearNotes()`

Usuwa wszystkie notatki w arkuszu.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.clearNotes();

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`collapseAllColumnGroups()`

Zwija wszystkie grupy kolumn w arkuszu.

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

// All column groups on the sheet are collapsed.
sheet.collapseAllColumnGroups();

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`collapseAllRowGroups()`

Zwija wszystkie grupy wierszy w arkuszu.

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

// All row groups on the sheet are collapsed.
sheet.collapseAllRowGroups();

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copyTo(spreadsheet)`

Kopiuje arkusz do wybranego arkusza kalkulacyjnego, który może być tym samym arkuszem kalkulacyjnym co arkusz źródłowy. Skopiowany arkusz ma nazwę „Kopia [oryginalna nazwa]”.

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

var destination = SpreadsheetApp.openById('ID_GOES HERE');
sheet.copyTo(destination);

Parametry

Nazwa	Typ	Opis
`spreadsheet`	`Spreadsheet`	Arkusz kalkulacyjny, do którego chcesz skopiować ten arkusz – może to być ten sam arkusz kalkulacyjny co arkusz źródłowy.

Powroty

Sheet – nowy arkusz do łączenia w łańcuchy.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createDeveloperMetadataFinder()`

Zwraca DeveloperMetadataFinder do wyszukiwania metadanych dewelopera w zakresie tego arkusza. Metadane należą do zakresu konkretnego arkusza, jeśli są powiązane z samym arkuszem albo z wierszem, kolumną lub zakresem w tym arkuszu.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds developer metadata for testing.
sheet.addDeveloperMetadata('CITY', 'PARIS');

// Creates the developer metadata finder.
const metadatafinder = sheet.createDeveloperMetadataFinder();

// Finds the metadata with value 'PARIS' and displays its key in the console.
console.log(metadatafinder.withValue('PARIS').find()[0].getKey());

Powroty

DeveloperMetadataFinder – wyszukiwarka metadanych dewelopera umożliwiająca wyszukiwanie metadanych w zakresie tego arkusza.

`createTextFinder(findText)`

Tworzy w arkuszu wyszukiwarkę tekstu, która może znajdować i zastępować tekst w arkuszu.

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

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

// Returns the first occurrence of 'dog' in the sheet.
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.

Powroty

TextFinder – TextFinder arkusza.

`deleteColumn(columnPosition)`

Usuwa kolumnę znajdującą się w danym miejscu.

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, począwszy od 1 dla pierwszej kolumny.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteColumns(columnPosition, howMany)`

Usuwa liczbę kolumn, zaczynając od podanej pozycji kolumny.

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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteRow(rowPosition)`

Usuwa wiersz na podanej 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, zaczynająca się od 1 w pierwszym wierszu.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteRows(rowPosition, howMany)`

Usuwa wiele wierszy, zaczynając od określonej pozycji wiersza.

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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`expandAllColumnGroups()`

Rozwija wszystkie grupy kolumn w arkuszu. Ta metoda wymaga co najmniej 1 grupy kolumn.

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

// All column groups on the sheet are expanded.
sheet.expandAllColumnGroups();

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`expandAllRowGroups()`

Rozwija wszystkie grupy wierszy w arkuszu. Ta metoda wymaga co najmniej 1 grupy wierszy.

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

// All row groups on the sheet are expanded.
sheet.expandAllRowGroups();

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`expandColumnGroupsUpToDepth(groupDepth)`

Rozwija wszystkie grupy kolumn do podanej głębokości i zwija wszystkie pozostałe.

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

// All column groups of depth 2 and lower are expanded, and groups with depth
// 3 and higher are collapsed.
sheet.expandColumnGroupsUpToDepth(2);

Parametry

Nazwa	Typ	Opis
`groupDepth`	`Integer`	Głębokość grupy, do której ma zostać rozwijana grupa kolumn.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`expandRowGroupsUpToDepth(groupDepth)`

Rozwija wszystkie grupy wierszy do podanej głębokości i zwija wszystkie pozostałe.

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

// All row groups of depth 2 and lower are expanded, and groups with depth
// 3 and higher are collapsed.
sheet.expandRowGroupsUpToDepth(2);

Parametry

Nazwa	Typ	Opis
`groupDepth`	`Integer`	Głębokość grupy, do której ma zostać rozwijana grupa wierszy.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getActiveCell()`

Zwraca aktywną komórkę w tym arkuszu.

Uwaga: zalecamy użycie getCurrentCell(), który zwraca aktualnie podświetloną komórkę.

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

Powroty

Range – bieżąca aktywna komórka,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`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 ostatnio wybrany zakres.

Termin „aktywny zakres” odnosi się do zakresu wybranego przez użytkownika w aktywnym arkuszu, ale w funkcji niestandardowej odnosi się do komórki, która jest aktywnie przeliczana.

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

Powroty

Range – aktywny zakres,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Zobacz też

setActiveRange(range)

`getActiveRangeList()`

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

Jeśli został wybrany 1 zakres, działa to jak wywołanie getActiveRange().

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

Powroty

RangeList – lista aktywnych zakresów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Zobacz też

setActiveRangeList(rangeList)

`getBandings()`

Zwraca wszystkie pasma w tym arkuszu.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the banding info for the sheet.
const bandings = sheet.getBandings();

// Gets info on the bandings' second row color and logs it to the console.
for (const banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Powroty

Banding[] – wszystkie pasy w tym arkuszu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getCharts()`

Zwraca tablicę wykresów z tego arkusza.

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

for (var i in charts) {
  var chart = charts[i];
  // Do something with the chart
}

Powroty

EmbeddedChart[] – tablica wykresów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getColumnGroup(columnIndex, groupDepth)`

Zwraca grupę kolumn o podanym indeksie i głębokości grupy.

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

// Returns the group whose control index is at column 2 and has a depth of 1, or
// null if the group doesn’t exist.
var columnGroup = sheet.getColumnGroup(2, 1);

Parametry

Nazwa	Typ	Opis
`columnIndex`	`Integer`	Indeks kolumny przełącznika kontroli grupy lub indeksu w grupie.
`groupDepth`	`Integer`	Głębia grupy.

Powroty

Group – grupa kolumn w indeksie kontrolnym i w głębokości lub zgłasza wyjątek, jeśli grupa nie istnieje.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getColumnGroupControlPosition()`

Zwraca wartość GroupControlTogglePosition dla wszystkich grup kolumn w arkuszu.

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

// GroupControlTogglePosition.AFTER if the column grouping control toggle is shown after the
// group.
var columnGroupControlPosition = sheet.getColumnGroupControlPosition();

Powroty

GroupControlTogglePosition – true, jeśli przełącznik sterowania grupowaniem kolumn jest wyświetlany za grupą w tym arkuszu, lub false w innym przypadku.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getColumnGroupDepth(columnIndex)`

Zwraca głębokość grupy w kolumnie dla podanego indeksu.

Głębokość grupy wskazuje, ile grup pokrywa się z kolumną. Mieści się w zakresie od 0 do 8.

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

// 1 if there is a group over columns 1 through 3
var groupDepth = sheet.getColumnGroupDepth(1);

Parametry

Nazwa	Typ	Opis
`columnIndex`	`Integer`	Indeks kolumny.

Powroty

Integer – głębokość grupy kolumny dla danego indeksu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getColumnWidth(columnPosition)`

Pobiera szerokość danej kolumny w pikselach.

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

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

Parametry

Nazwa	Typ	Opis
`columnPosition`	`Integer`	Położenie kolumny do sprawdzenia.

Powroty

Integer – szerokość kolumny w pikselach

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getConditionalFormatRules()`

Pobierz wszystkie reguły formatowania warunkowego w tym arkuszu.

// Logs the conditional format rules in a sheet.
var rules = SpreadsheetApp.getActiveSheet().getConditionalFormatRules();
for (var i = 0; i < rules.length; i++) {
  var rule = rules[i];
  Logger.log(rule);
}

Powroty

ConditionalFormatRule[] – tablica wszystkich reguł w arkuszu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getCurrentCell()`

Zwraca bieżącą komórkę w aktywnym arkuszu lub null, jeśli nie ma bieżącej komórki. Bieżąca komórka to ta, która jest wyróżniona w interfejsie Arkuszy Google i jest wyróżniona ciemną obwódką. Nie ma więcej niż jednej komórki. Gdy użytkownik wybierze co najmniej 1 zakres komórek, jedna z komórek w zaznaczeniu stanie się komórką bieżącą.

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

Powroty

Range – bieżąca komórka,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataRange()`

Zwraca wartość Range odpowiadającą wymiarowi, w którym znajdują się dane.

Jest to funkcjonalnie odpowiednik utworzenia zakresu ograniczonego przez komórki 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);
}

Powroty

Range – zakres składający się ze wszystkich danych z arkusza kalkulacyjnego;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceFormulas()`

Pobiera wszystkie formuły źródeł danych.

// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets
// file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of the data source formulas on Sheet1.
// To get an array of data source formulas for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceFormulas = sheet.getDataSourceFormulas();

// Logs the first data source formula in the array.
console.log(dataSourceFormulas[0].getFormula());

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourcePivotTables()`

Pobiera wszystkie tabele przestawne źródła danych.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of the data source pivot tables on Sheet1.
// To get an array of data source pivot tables for the entire
// spreadsheet, replace 'sheet' with 'ss'.
const dataSourcePivotTables = sheet.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceTables()`

Pobiera wszystkie tabele źródeł danych.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of data source tables on Sheet1.
// To get an array of data source tables for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceTables = sheet.getDataSourceTables();

// Logs the last completed data execution time on the first data source table.
console.log(dataSourceTables[0].getStatus().getLastExecutionTime());

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDeveloperMetadata()`

Pobierz wszystkie metadane dewelopera powiązane z tym arkuszem.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds developer metadata for testing.
sheet.addDeveloperMetadata('CITY', 'PARIS');

// Gets all the developer metadata for the sheet.
const developerMetaDataList = sheet.getDeveloperMetadata();

// Logs the developer metadata to the console.
for (const developerMetaData of developerMetaDataList) {
  console.log(developerMetaData.getKey());
}

Powroty

DeveloperMetadata[] – metadane dewelopera powiązane z tym arkuszem.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDrawings()`

Zwraca tablicę rysunków w arkuszu.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all the drawings from the sheet.
const allDrawings = sheet.getDrawings();

 // Logs the number of drawings present on the sheet.
console.log(allDrawings.length);

Powroty

Drawing[] – lista rysunków w arkuszu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFilter()`

Zwraca filtr w tym arkuszu lub null, jeśli nie ma filtra.

// Gets the filter on the active sheet.
let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();

Powroty

Filter – filtr.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormUrl()`

Zwraca adres URL formularza, który wysyła odpowiedzi do tego arkusza, lub null, jeśli arkusz nie ma powiązanego formularza.

var sheet = SpreadsheetApp.getActiveSheet();
var url = sheet.getFormUrl();

Powroty

String – adres URL formularza, który umieszcza odpowiedzi w tym arkuszu, lub null, jeśli arkusz nie ma powiązanego formularza.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFrozenColumns()`

Zwraca liczbę zablokowanych kolumn.

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

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

Powroty

Integer – liczba zablokowanych kolumn;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFrozenRows()`

Zwraca liczbę zablokowanych wierszy.

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

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

Powroty

Integer – liczba zablokowanych wierszy,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getImages()`

Zwraca wszystkie obrazy w siatce.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the over-the-grid images from Sheet1.
// To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead.
const images = sheet.getImages();

// For each image, logs the anchor cell in A1 notation.
for (const image of images) {
 console.log(image.getAnchorCell().getA1Notation());
}

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getIndex()`

Pobiera pozycję arkusza w nadrzędnym arkuszu kalkulacyjnym. Zaczyna się o 1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
// Note that the JavaScript index is 0, but this logs 1
var sheet = ss.getSheets()[0];
// ... because spreadsheets are 1-indexed
Logger.log(sheet.getIndex());

Powroty

Integer – pozycja arkusza w jego nadrzędnym arkuszu kalkulacyjnym.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getLastColumn()`

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

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());

Powroty

Integer – ostatnia kolumna w arkuszu, która zawiera treść.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getLastRow()`

Zwraca pozycję ostatniego wiersza zawierającego treść.

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());

Powroty

Integer – ostatni wiersz arkusza zawierający treść,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getMaxColumns()`

Zwraca aktualną liczbę kolumn w arkuszu niezależnie od treści.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
Logger.log(first.getMaxColumns());

Powroty

Integer – maksymalna szerokość arkusza.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getMaxRows()`

Zwraca aktualną liczbę wierszy w arkuszu niezależnie od treści.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
Logger.log(first.getMaxRows());

Powroty

Integer – maksymalna wysokość arkusza.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getName()`

Zwraca nazwę arkusza.

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

Powroty

String – nazwa arkusza.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNamedRanges()`

Pobiera wszystkie zakresy nazwane z tego arkusza.

// The code below logs the name of the first named range.
var namedRanges = SpreadsheetApp.getActiveSheet().getNamedRanges();
if (namedRanges.length > 1) {
  Logger.log(namedRanges[0].getName());
}

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getParent()`

Zwraca wartość Spreadsheet zawierającą ten arkusz.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// parent is identical to ss
var parent = sheet.getParent();

Powroty

Spreadsheet – nadrzędny arkusz kalkulacyjny.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getPivotTables()`

Zwraca wszystkie tabele przestawne w tym arkuszu.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all the pivot table info for the sheet.
const pivotTables = sheet.getPivotTables();

// Logs the pivot tables to the console.
for (const pivotTable of pivotTables) {
  console.log(pivotTable.getSourceDataRange().getValues());
}

Powroty

PivotTable[] – tabele przestawne w arkuszu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getProtections(type)`

Pobiera tablicę obiektów reprezentującą wszystkie chronione zakresy w arkuszu lub tablicę jednoelementową reprezentującą ochronę w samym arkuszu.

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

// Remove sheet protection from the active sheet, if the user has permission to edit it.
var sheet = SpreadsheetApp.getActiveSheet();
var protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0];
if (protection && protection.canEdit()) {
  protection.remove();
}

Parametry

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

Powroty

Protection[] – tablica obiektów reprezentująca wszystkie chronione zakresy w arkuszu lub tablica jednoelementowa reprezentująca ochronę w samym arkuszu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRange(row, column)`

Zwraca zakres z lewą górną komórką o podanych współrzędnych.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Passing only two arguments returns a "range" with a single cell.
var range = sheet.getRange(1, 1);
var values = range.getValues();
Logger.log(values[0][0]);

Parametry

Nazwa	Typ	Opis
`row`	`Integer`	Indeks wiersza komórki do zwrócenia; indeksowanie wierszy rozpoczyna się od 1.
`column`	`Integer`	Indeks kolumny komórki, która ma zostać zwrócona; indeksowanie kolumn rozpoczyna się od 1.

Powroty

Range – zakres zawierający tylko tę komórkę.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRange(row, column, numRows)`

Zwraca zakres z lewą górną komórką o podanych współrzędnych i z podaną liczbą wierszy.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// When the "numRows" argument is used, only a single column of data is returned.
var range = sheet.getRange(1, 1, 3);
var values = range.getValues();

// Prints 3 values from the first column, starting from row 1.
for (var row in values) {
  for (var col in values[row]) {
    Logger.log(values[row][col]);
  }
}

Parametry

Nazwa	Typ	Opis
`row`	`Integer`	Indeks początkowego wiersza zakresu; indeksowanie wierszy rozpoczyna się od 1.
`column`	`Integer`	Indeks kolumny zakresu. Indeksowanie kolumn zaczyna się od 1.
`numRows`	`Integer`	Liczba wierszy do zwrócenia.

Powroty

Range – zakres zawierający jedną kolumnę danych o określonej liczbie wierszy.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRange(row, column, numRows, numColumns)`

Zwraca zakres z lewą górną komórką o podanych współrzędnych dla podanej liczby wierszy i kolumn.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange(1, 1, 3, 3);
var values = range.getValues();

// Print values from a 3x3 box.
for (var row in values) {
  for (var col in values[row]) {
    Logger.log(values[row][col]);
  }
}

Parametry

Nazwa	Typ	Opis
`row`	`Integer`	Indeks początkowego wiersza zakresu; indeksowanie wierszy rozpoczyna się od 1.
`column`	`Integer`	Indeks kolumny początkowej zakresu. Indeksowanie kolumn zaczyna się od 1.
`numRows`	`Integer`	Liczba wierszy do zwrócenia.
`numColumns`	`Integer`	Liczba kolumn do zwrócenia.

Powroty

Range – zakres odpowiadający określonemu obszarowi.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRange(a1Notation)`

Zwraca zakres określony w notacji A1 lub w 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 do zwrócenia, określony w notacji A1 lub w notacji R1C1.

Powroty

Range – zakres w lokalizacji określonej

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRangeList(a1Notations)`

Zwraca kolekcję RangeList reprezentującą zakresy w tym samym arkuszu określoną za pomocą niepustej listy 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.

Powroty

RangeList – lista zakresów w lokalizacji wskazanej

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRowGroup(rowIndex, groupDepth)`

Zwraca grupę wierszy o podanym indeksie i głębokości grupy.

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

// Returns the group whose control index is at row 2 and has a depth of 1, or
// null if the group doesn’t exist.
var rowGroup = sheet.getRowGroup(2, 1);

Parametry

Nazwa	Typ	Opis
`rowIndex`	`Integer`	Indeks wiersza przełącznika kontroli grupy lub indeksu w grupie.
`groupDepth`	`Integer`	Głębia grupy.

Powroty

Group – grupa wierszy w indeksie kontrolnym i w głębokości lub zgłasza wyjątek, jeśli grupa nie istnieje.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRowGroupControlPosition()`

Zwraca wartość GroupControlTogglePosition w przypadku wszystkich grup wierszy w arkuszu.

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

// GroupControlTogglePosition.AFTER if the row grouping control toggle is shown after the
// group.
var rowGroupControlPosition = sheet.getRowGroupControlPosition();

Powroty

GroupControlTogglePosition – true, jeśli przełącznik sterowania grupowaniem wierszy jest widoczny za grupą w tym arkuszu, lub false w innym przypadku.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRowGroupDepth(rowIndex)`

Zwraca głębokość grupy wiersza w danym indeksie.

Głębokość grupy wskazuje, ile grup pokrywa się z wierszem. Mieści się w zakresie od 0 do 8.

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

// 1 if there is a group over rows 1 through 3
var groupDepth = sheet.getRowGroupDepth(1);

Parametry

Nazwa	Typ	Opis
`rowIndex`	`Integer`	Indeks wiersza.

Powroty

Integer – głębokość grupy wiersza dla danego indeksu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRowHeight(rowPosition)`

Pobiera wysokość danego wiersza w pikselach.

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.

Powroty

Integer – wysokość wiersza w pikselach

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSelection()`

Zwraca bieżącą wartość Selection z arkusza kalkulacyjnego.

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

Powroty

Selection – bieżący wybór;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheetId()`

Zwraca identyfikator arkusza reprezentowanego przez ten obiekt.

Jest to identyfikator arkusza, który jest unikalny dla tego arkusza kalkulacyjnego. Identyfikator to rosnąca monotonicznie liczba całkowita przypisywana w momencie tworzenia arkusza, niezależna od jego pozycji. Jest to przydatne w połączeniu z metodami takimi jak Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd), które przyjmują parametr gridId, a nie instancję Sheet.

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

Logger.log(sheet.getSheetId());

Powroty

Integer – unikalny identyfikator arkusza kalkulacyjnego dla danego arkusza kalkulacyjnego;

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheetName()`

Zwraca nazwę arkusza.

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

Logger.log(sheet.getSheetName());

Powroty

String – nazwa arkusza,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheetValues(startRow, startColumn, numRows, numColumns)`

Zwraca prostokątną siatkę wartości dla tego zakresu, zaczynając od podanych współrzędnych. Wartość -1 podana jako pozycja wiersza lub kolumny odpowiada uzyskaniu ostatniego wiersza lub kolumny, które zawierają dane 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, dla których mają zostać zwrócone wartości.
`numColumns`	`Integer`	Liczba kolumn, dla których mają zostać zwrócone wartości.

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSlicers()`

Zwraca tablicę fragmentatorów w arkuszu.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all slicers in the spreadsheet.
const slicers = sheet.getSlicers();

// Logs the slicer titles to the console.
for (const slicer of slicers) {
  console.log(slicer.getTitle());
}

Powroty

Slicer[] – lista fragmentatorów w danym arkuszu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTabColorObject()`

Pobiera kolor karty arkusza lub null, jeśli karta arkusza nie ma koloru.

// This example assumes there is a sheet named "Sheet1"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("Sheet1");
var color = first.getTabColorObject();

Powroty

Color – kolor karty arkusza lub null, jeśli karta nie ma koloru.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getType()`

Zwraca typ arkusza.

Domyślny typ arkusza to SheetType.GRID. Arkusz zawierający 1 umieszczony obiekt, np. EmbeddedChart, jest arkuszem SheetType.OBJECT.

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

Powroty

SheetType – typ arkusza.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hasHiddenGridlines()`

Zwraca wartość true, jeśli linie siatki w arkuszu są ukryte. W przeciwnym razie zwraca wartość false. Linie siatki są domyślnie widoczne.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Checks if the spreadsheet has hidden gridelines and logs the result to the console.
console.log(sheet.hasHiddenGridlines());

Powroty

Boolean – true, jeśli linie siatki są ukryte; w przeciwnym razie: false.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hideColumn(column)`

Ukrywa kolumnę 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hideColumns(columnIndex)`

Ukrywa jedną kolumnę w danym indeksie. W przypadku tej metody używaj indeksu 1.

Aby ukryć więcej niż jedną kolumnę za pomocą indeksu, użyj funkcji hideColumns(columnIndex, numColumns).

Aby ukryć więcej niż jedną kolumnę za pomocą zakresu, użyj hideColumn().

let ss = SpreadsheetApp.getActiveSpreadsheet();
let sheet = ss.getSheets()[0];
// Hides the first column
sheet.hideColumns(1);

Parametry

Nazwa	Typ	Opis
`columnIndex`	`Integer`	Indeks kolumny do ukrycia.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hideColumns(columnIndex, numColumns)`

Ukrywa co najmniej 1 kolumnę z rzędu, zaczynając od danego indeksu. W przypadku tej metody używaj indeksu 1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Hides the first three columns
sheet.hideColumns(1, 3);

Parametry

Nazwa	Typ	Opis
`columnIndex`	`Integer`	Indeks początkowy kolumn do ukrycia.
`numColumns`	`Integer`	Liczba kolumn do ukrycia.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hideRows(rowIndex)`

Ukrywa wiersz o podanym indeksie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Hides the first row
sheet.hideRows(1);

Parametry

Nazwa	Typ	Opis
`rowIndex`	`Integer`	Indeks wiersza do ukrycia.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hideRows(rowIndex, numRows)`

Ukrywa co najmniej 1 wiersz z rzędu, zaczynając od danego indeksu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Hides the first three rows
sheet.hideRows(1, 3);

Parametry

Nazwa	Typ	Opis
`rowIndex`	`Integer`	Indeks początkowy wierszy do ukrycia.
`numRows`	`Integer`	Liczba wierszy do ukrycia.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hideSheet()`

Ukrywa ten arkusz. Nie działa, jeśli arkusz jest już ukryty. Jeśli ta metoda zostanie wywołana w jedynym widocznym arkuszu, spowoduje zgłoszenie wyjątku.

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

Powroty

Sheet – bieżący arkusz.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertChart(chart)`

Dodaje nowy wykres do tego arkusza.

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

// This creates a simple bar chart from the first three rows
// of the first two columns of the spreadsheet
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B4"))
    .setPosition(5, 5, 0, 0)
    .setOption("title", "Dynamic Chart")
    .build();
sheet.insertChart(chart);

Parametry

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnAfter(afterPosition)`

Wstawia kolumnę po podanej pozycji 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, po której należy dodać nową kolumnę.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnBefore(beforePosition)`

Wstawia kolumnę przed podaną 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, do której należy dodać nową kolumnę.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumns(columnIndex)`

Wstawia pustą kolumnę w arkuszu w określonej lokalizacji.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Shifts all columns by one
sheet.insertColumns(1);

Parametry

Nazwa	Typ	Opis
`columnIndex`	`Integer`	Indeks wskazujący, gdzie należy wstawić kolumnę.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumns(columnIndex, numColumns)`

Wstawia jedną lub kilka następujących po sobie pustych kolumn w arkuszu, zaczynając od określonej lokalizacji.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Shifts all columns by three
sheet.insertColumns(1, 3);

Parametry

Nazwa	Typ	Opis
`columnIndex`	`Integer`	Indeks wskazujący, gdzie należy wstawić kolumnę.
`numColumns`	`Integer`	Liczba kolumn do wstawienia.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnsAfter(afterPosition, howMany)`

Wstawia podaną liczbę kolumn po podanej pozycji kolumny.

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

// Inserts two columns after the first column on the first sheet of the spreadsheet.
sheet.insertColumnsAfter(1,2);

Parametry

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

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnsBefore(beforePosition, howMany)`

Wstawia pewną liczbę kolumn przed podaną pozycją kolumny.

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, do której należy dodać nową kolumnę.
`howMany`	`Integer`	Liczba kolumn do wstawienia.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(blobSource, column, row)`

Wstawia BlobSource jako obraz w dokumencie w danym wierszu i kolumnie. Rozmiar obrazu jest pobierany z zawartości obiektu blob. 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);

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.

Powroty

OverGridImage – wstawiony obraz.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

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

Wstawia BlobSource jako obraz w dokumencie w określonym wierszu i kolumnie z przesunięciem piksela. Rozmiar obrazu jest pobierany z zawartości obiektu blob. 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`	Odsunięcie w poziomie od narożnika komórki w pikselach.
`offsetY`	`Integer`	Odsunięcie w pionie od narożnika komórki w pikselach.

Powroty

OverGridImage – wstawiony obraz.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(url, column, row)`

Wstawia obraz w dokumencie w danym wierszu i kolumnie.

Podany adres URL musi być publicznie dostępny.

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.

Powroty

OverGridImage – wstawiony obraz.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

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

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

Podany adres URL musi być publicznie dostępny.

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`	Odsunięcie w poziomie od narożnika komórki w pikselach.
`offsetY`	`Integer`	Odsunięcie w pionie od narożnika komórki w pikselach.

Powroty

OverGridImage – wstawiony obraz.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowAfter(afterPosition)`

Wstawia wiersz po podanej pozycji wiersza.

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.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowBefore(beforePosition)`

Wstawia wiersz przed podaną pozycją wiersza.

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.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRows(rowIndex)`

Wstawia pusty wiersz w arkuszu w określonej lokalizacji.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Shifts all rows down by one
sheet.insertRows(1);

Parametry

Nazwa	Typ	Opis
`rowIndex`	`Integer`	Indeks wskazujący, gdzie należy wstawić wiersz.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRows(rowIndex, numRows)`

Wstawia jeden lub kilka następujących po sobie pustych wierszy w arkuszu, zaczynając od określonej lokalizacji.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Shifts all rows down by three
sheet.insertRows(1, 3);

Parametry

Nazwa	Typ	Opis
`rowIndex`	`Integer`	Indeks wskazujący, gdzie należy wstawić wiersz.
`numRows`	`Integer`	Liczba wierszy do wstawienia.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowsAfter(afterPosition, howMany)`

Wstawia liczbę wierszy po podanej 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 mają zostać dodane nowe wiersze.
`howMany`	`Integer`	Liczba wierszy do wstawienia.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowsBefore(beforePosition, howMany)`

Wstawia pewną liczbę wierszy przed podaną pozycją wiersza.

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, do którego należy dodać nowe wiersze.
`howMany`	`Integer`	Liczba wierszy do wstawienia.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSlicer(range, anchorRowPos, anchorColPos)`

Dodaje nowy fragmentator do tego arkusza.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range of the sheet.
const range = sheet.getRange('A1:D10');

// Inserts the slicer with a random range into the sheet.
const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10);

// Logs the insert slicer result to the console.
console.log(insertSlicers);

Parametry

Nazwa	Typ	Opis
`range`	`Range`	Zakres, w którym tworzony jest fragmentator.
`anchorRowPos`	`Integer`	Górna strona fragmentatora jest zakotwiczona w tym wierszu.
`anchorColPos`	`Integer`	Górna strona fragmentatora jest zakotwiczona w tej kolumnie

Powroty

Slicer – nowo wstawiony filtr.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)`

Dodaje nowy fragmentator do tego arkusza.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range.
const range = sheet.getRange('A1:D10');

// Inserts a slicer using the random range function.
const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10, 0, 0);

// Logs the insert slicer result to the console.
console.log(insertSlicers);

Parametry

Nazwa	Typ	Opis
`range`	`Range`	Zakres, w którym tworzony jest fragmentator.
`anchorRowPos`	`Integer`	Górna strona fragmentatora jest zakotwiczona w tym wierszu.
`anchorColPos`	`Integer`	Górna strona fragmentatora jest zakotwiczona w tej kolumnie
`offsetX`	`Integer`	Odsunięcie w poziomie od narożnika komórki w pikselach.
`offsetY`	`Integer`	Odsunięcie w pionie od narożnika komórki w pikselach.

Powroty

Slicer – nowo wstawiony filtr.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isColumnHiddenByUser(columnPosition)`

Zwraca, 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`	Położenie kolumny do sprawdzenia.

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isRightToLeft()`

Zwraca wartość true, jeśli układ arkusza jest ułożony od prawej do lewej. Zwraca wartość false, jeśli arkusz używa domyślnego układu od lewej do prawej.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Checks if a spreadsheet is ordered from right to left and logs the result to the console.
console.log(sheet.isRightToLeft());

Powroty

Boolean – true, jeśli tekst jest od prawej do lewej. W przeciwnym razie false.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isRowHiddenByFilter(rowPosition)`

Zwraca, czy dany wiersz został ukryty przez filtr (a nie przez widok 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.

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isRowHiddenByUser(rowPosition)`

Zwraca, 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.

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isSheetHidden()`

Zwraca wartość true, jeśli arkusz jest obecnie ukryty.

var sheet = SpreadsheetApp.getActiveSheet();
if (sheet.isSheetHidden()) {
  // do something...
}

Powroty

Boolean – true, jeśli arkusz jest ukryty. W przeciwnym razie false.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`moveColumns(columnSpec, destinationIndex)`

Przenosi kolumny zaznaczone w danym zakresie do pozycji wskazanej w kolumnie destinationIndex. Sama właściwość columnSpec nie musi dokładnie przedstawiać całej kolumny ani grupy kolumn do przeniesienia – wybiera wszystkie kolumny, które obejmują zakres.

// The code below moves rows A-B to destination index 5.
// This results in those columns becoming columns C-D.
var sheet = SpreadsheetApp.getActiveSheet();
// Selects column A and column B to be moved.
var columnSpec = sheet.getRange("A1:B1");
sheet.moveColumns(columnSpec, 5);

Parametry

Nazwa	Typ	Opis
`columnSpec`	`Range`	Zakres obejmujący kolumny, które należy przenieść.
`destinationIndex`	`Integer`	Indeks, do którego należy przenieść kolumny. Pamiętaj, że indeks jest oparty na współrzędnych przed przeniesieniem kolumn. Istniejące dane są przesuwane w prawo, aby zrobić miejsce na przeniesione kolumny, a kolumny źródłowe są usuwane z siatki. W związku z tym dane mogą trafić do innego indeksu niż pierwotnie określone.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`moveRows(rowSpec, destinationIndex)`

Przenosi wiersze zaznaczone przez podany zakres do pozycji wskazanej przez wartość destinationIndex. Sama właściwość rowSpec nie musi dokładnie przedstawiać całego wiersza ani grupy wierszy do przeniesienia – wybiera wszystkie wiersze, które obejmują zakres.

// The code below moves rows 1-2 to destination index 5.
// This results in those rows becoming rows 3-4.
var sheet = SpreadsheetApp.getActiveSheet();
// Selects row 1 and row 2 to be moved.
var rowSpec = sheet.getRange("A1:A2");
sheet.moveRows(rowSpec, 5);

Parametry

Nazwa	Typ	Opis
`rowSpec`	`Range`	Zakres obejmujący wiersze, które należy przenieść.
`destinationIndex`	`Integer`	Indeks, do którego mają zostać przeniesione wiersze. Pamiętaj, że indeks jest oparty na współrzędnych przed przeniesieniem wierszy. Istniejące dane są przesuwane w dół, aby zrobić miejsce na przeniesione wiersze, a wiersze źródłowe są usuwane z siatki. W związku z tym dane mogą trafić do innego indeksu niż pierwotnie określone.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`newChart()`

Zwraca narzędzie do utworzenia nowego wykresu w tym arkuszu.

Ten przykład pokazuje, jak utworzyć nowy wykres:

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B8");
var chartBuilder = sheet.newChart();
chartBuilder.addRange(range)
    .setChartType(Charts.ChartType.LINE)
    .setPosition(2, 2, 0, 0)
    .setOption('title', 'My Line Chart!');
sheet.insertChart(chartBuilder.build());

Powroty

EmbeddedChartBuilder – narzędzie do tworzenia nowych wykresów.

`protect()`

Tworzy obiekt, który może chronić przed edytowaniem arkusza – nie dotyczy to użytkowników z odpowiednimi uprawnieniami. Dopóki skrypt nie zmieni listy edytorów arkusza (przez wywołanie Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) lub ustawienie nowej wartości Protection.setDomainEdit(editable)), uprawnienia odzwierciedlają uprawnienia samego arkusza kalkulacyjnego, co w efekcie oznacza, że arkusz pozostaje niechroniony. Jeśli arkusz jest już chroniony, ta metoda zwraca obiekt reprezentujący dotychczasowe ustawienia ochrony. Chroniony arkusz może zawierać niechronione regiony.

// Protect the active sheet, then remove all other users from the list of editors.
var sheet = SpreadsheetApp.getActiveSheet();
var protection = sheet.protect().setDescription('Sample protected sheet');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Powroty

Protection – obiekt reprezentujący ustawienia zabezpieczeń.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeChart(chart)`

Usuwa wykres z arkusza nadrzędnego.

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

// This removes all the embedded charts from the spreadsheet
var charts = sheet.getCharts();
for (var i in charts) {
  sheet.removeChart(charts[i]);
}

Parametry

Nazwa	Typ	Opis
`chart`	`EmbeddedChart`	Wykres do usunięcia.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveRange(range)`

Ustawia określony zakres jako active range w aktywnym arkuszu, a lewa górna komórka w zakresie to 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 do ustawienia jako aktywny zakres.

Powroty

Range – nowo aktywny zakres

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveRangeList(rangeList)`

Ustawia określoną listę zakresów jako active ranges w aktywnym arkuszu. 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.

Powroty

RangeList – nowo wybrana lista zakresów,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSelection(range)`

Określa aktywny region zaznaczenia 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 do ustawienia jako aktywny.

Powroty

Range – nowo aktywny zakres

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSelection(a1Notation)`

Ustawia aktywne zaznaczenie zgodnie z zapisem A1 lub notacją R1C1.

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

sheet.setActiveSelection("A1:D4");

Parametry

Nazwa	Typ	Opis
`a1Notation`	`String`	Zakres do ustawienia jako aktywny, zgodnie z zapisem A1 lub notacją R1C1.

Powroty

Range – nowo aktywny zakres

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setColumnGroupControlPosition(position)`

Określa pozycję przełącznika kontroli grupy kolumn w arkuszu.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setColumnGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);

Parametry

Nazwa	Typ	Opis
`position`	`GroupControlTogglePosition`	Położenie przełącznika kontrolującego grupę kolumn.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`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ść ustawiona w pikselach.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setColumnWidths(startColumn, numColumns, width)`

Ustawia szerokość danych kolumn w pikselach.

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

// Sets the first three columns to a width of 200 pixels
sheet.setColumnWidths(1, 3, 200);

Parametry

Nazwa	Typ	Opis
`startColumn`	`Integer`	Pozycja kolumny początkowej do zmiany.
`numColumns`	`Integer`	Liczba kolumn do zmiany.
`width`	`Integer`	Szerokość ustawiona w pikselach.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setConditionalFormatRules(rules)`

Zastępuje wszystkie istniejące reguły formatowania warunkowego w arkuszu regułami wejściowymi. Reguły są sprawdzane w kolejności wejściowej.

// Remove one of the existing conditional format rules.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
rules.splice(1, 1); // Deletes the 2nd format rule.
sheet.setConditionalFormatRules(rules);

Parametry

Nazwa	Typ	Opis
`rules`	`ConditionalFormatRule[]`	Nowe reguły formatowania warunkowego.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setCurrentCell(cell)`

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

Jeśli wskazana komórka znajduje się w już wybranym zakresie, ten zakres stanie się aktywnym zakresem z komórką bieżącą.

Jeśli określona komórka nie znajduje się w żadnym zaznaczonym zakresie, wszystkie dotychczasowe zaznaczenie zostaną usunięte, a komórka stanie się komórką bieżącą i aktywnym zakresem.

Uwaga: podany Range musi składać się z jednej komórki w przeciwnym razie spowoduje zgłoszenie wyjątku.

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 zostać ustawiona jako bieżąca komórka.

Powroty

Range – nowo ustawiona bieżąca komórka,

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFrozenColumns(columns)`

Blokuje podaną liczbę kolumn. Jeśli wartość wynosi 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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFrozenRows(rows)`

Blokuje podaną liczbę wierszy. Jeśli wartość wynosi zero, żaden wiersz nie jest zablokowany.

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 korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHiddenGridlines(hideGridlines)`

Ukrywa lub ujawnia linie siatki w arkuszu.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can us eSpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Hides the gridlines in the sheet.
sheet.setHiddenGridlines(true);

Parametry

Nazwa	Typ	Opis
`hideGridlines`	`Boolean`	Jeśli ustawiona jest wartość `true`, ukryj linie siatki w tym arkuszu. W przeciwnym razie pokaż linie siatki.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setName(name)`

Określa nazwę arkusza.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.setName("not first anymore");

Parametry

Nazwa	Typ	Opis
`name`	`String`	Nowa nazwa arkusza.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRightToLeft(rightToLeft)`

Ustawia lub wyłącza układ arkusza od prawej do lewej.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets the sheet layout, so that the sheet is ordered from right to left.
sheet.setRightToLeft(true);

Parametry

Nazwa	Typ	Opis
`rightToLeft`	`Boolean`	Jeśli jest ustawiona wartość `true`, układ arkusza jest ustawiony na od prawej do lewej, z komórką A1 w prawym górnym rogu. Jeśli ustawiona jest wartość `false`, układ arkusza jest ustawiany na domyślny układ od lewej do prawej z komórką A1 w lewym górnym rogu.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRowGroupControlPosition(position)`

Określa pozycję przełącznika kontroli grupy wierszy w arkuszu.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setRowGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);

Parametry

Nazwa	Typ	Opis
`position`	`GroupControlTogglePosition`	Położenie przełącznika kontroli grupy wierszy.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRowHeight(rowPosition, height)`

Ustawia wysokość wiersza danego wiersza w pikselach. Domyślnie wiersze powiększają się, aby dopasować się do zawartości komórki. Jeśli chcesz wymusić, by wiersze miały określoną wysokość, użyj 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 do zmiany.
`height`	`Integer`	Wysokość, na jaką ma być ustawiona wartość w pikselach.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRowHeights(startRow, numRows, height)`

Ustawia wysokość danych wierszy w pikselach. Domyślnie wiersze powiększają się, aby dopasować się do zawartości komórki. Jeśli chcesz wymusić uzyskanie określonej wysokości wierszy, użyj funkcji setRowHeightsForced(startRow, numRows, height).

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

// Sets the first three rows to a height of 20 pixels
sheet.setRowHeights(1, 3, 20);

Parametry

Nazwa	Typ	Opis
`startRow`	`Integer`	Pozycja wiersza początkowego do zmiany.
`numRows`	`Integer`	Liczba wierszy do zmiany.
`height`	`Integer`	Wysokość, na jaką ma być ustawiona wartość w pikselach.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRowHeightsForced(startRow, numRows, height)`

Ustawia wysokość danych wierszy w pikselach. Domyślnie wiersze powiększają się, aby dopasować się do zawartości komórki. Gdy używasz właściwości setRowHeightsForced, wysokość wierszy jest wymuszana, nawet jeśli zawartość komórki jest wyższa niż wysokość wiersza.

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

// Sets the first three rows to a height of 5 pixels.
sheet.setRowHeightsForced(1, 3, 5);

Parametry

Nazwa	Typ	Opis
`startRow`	`Integer`	Pozycja wiersza początkowego do zmiany.
`numRows`	`Integer`	Liczba wierszy do zmiany.
`height`	`Integer`	Wysokość, na jaką ma być ustawiona wartość w pikselach.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTabColor(color)`

Ustawia kolor karty arkusza.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.setTabColor("ff0000"); // Set the color to red.
first.setTabColor(null); // Unset the color.

Parametry

Nazwa	Typ	Opis
`color`	`String`	Kod koloru w notacji CSS (np. `'#ffffff'` lub `'white'`) albo `null`, aby zresetować kolor karty.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setTabColorObject(color)`

Ustawia kolor karty arkusza.

// This example assumes there is a sheet named "Sheet1"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("Sheet1");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
first.setTabColorObject(color); // Set the color to theme accent 1.
first.setTabColorObject(null); // Unset the color.

Parametry

Nazwa	Typ	Opis
`color`	`Color`	Kolor karty arkusza do ustawienia.

Powroty

Sheet – ten arkusz na potrzeby łańcuchów.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`showColumns(columnIndex)`

Odkrywa kolumnę w danym indeksie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Unhides the first column
sheet.showColumns(1);

Parametry

Nazwa	Typ	Opis
`columnIndex`	`Integer`	Indeks kolumny do odkrycia.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`showColumns(columnIndex, numColumns)`

Odkrywa co najmniej 1 kolumnę z rzędu, zaczynając od danego indeksu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Unhides the first three columns
sheet.showColumns(1, 3);

Parametry

Nazwa	Typ	Opis
`columnIndex`	`Integer`	Indeks początkowy kolumn do odkrycia.
`numColumns`	`Integer`	Liczba kolumn do odkrycia.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`showRows(rowIndex)`

Odkrywa wiersz w danym indeksie.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Unhides the first row
sheet.showRows(1);

Parametry

Nazwa	Typ	Opis
`rowIndex`	`Integer`	Indeks wiersza do odkrycia.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`showRows(rowIndex, numRows)`

Pokazuje co najmniej 1 wiersz z rzędu, zaczynając od danego indeksu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Unhides the first three rows
sheet.showRows(1, 3);

Parametry

Nazwa	Typ	Opis
`rowIndex`	`Integer`	Indeks początkowy wierszy do odkrycia.
`numRows`	`Integer`	Liczba wierszy do odkrycia.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`showSheet()`

Sprawia, że arkusz jest widoczny. Jeśli arkusz jest już widoczny, nie działa.

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

Powroty

Sheet – bieżący arkusz.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`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, według której mają być sortowane dane.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`sort(columnPosition, ascending)`

Sortuje arkusz według kolumny. Przyjmuje parametr rosnący lub malejący.

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, według której mają być sortowane dane.
`ascending`	`Boolean`	`true` – sortowanie rosnąco, `false` – malejąco.

Powroty

Sheet – arkusz przydatny do tworzenia łańcuchów metod.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`unhideColumn(column)`

Odkrywa kolumnę w danym 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 odkrycia, jeśli jest ukryty.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`unhideRow(row)`

Odkrywa 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 odkrycia, jeśli jest ukryty.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`updateChart(chart)`

Aktualizuje wykres w tym arkuszu.

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

// This code is going to loop through all the charts and change them to
// column charts
var charts = sheet.getCharts();
for (var i in charts) {
  var chart = charts[i];
  var newChart = chart
      .modify()
      .setChartType(Charts.ChartType.COLUMN)
      .build();
  sheet.updateChart(newChart);
}

Parametry

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Wycofane metody

`getSheetProtection()`

Wycofano. W przypadku arkuszy kalkulacyjnych utworzonych w nowszej wersji Arkuszy Google użyj atrybutu getProtections(type), który zwraca skuteczniejszą klasę Protection. Ta metoda została wycofana, ale nadal jest dostępna i zapewnia zgodność ze starszą wersją Arkuszy

Zwraca wystąpienie PageProtection opisujące uprawnienia 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);

Powroty

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getTabColor()`

Wycofano. Zastąpione przez: getTabColorObject()

Pobiera kolor karty arkusza lub null, jeśli karta arkusza nie ma koloru.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
var color = first.getTabColor();

Powroty

String – kod koloru w notacji CSS (np. '#ffffff').

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSheetProtection(permissions)`

Wycofano. W przypadku arkuszy kalkulacyjnych utworzonych w nowszej wersji Arkuszy Google użyj atrybutu protect(), który zwraca skuteczniejszą klasę Protection. Ta metoda została wycofana, ale nadal jest dostępna i zapewnia zgodność 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 do ustawienia w tym arkuszu.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets