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. |
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ż
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ż
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