wyświetlać i modyfikować arkusze kalkulacyjne. Typowe operacje polegają na zmianie nazwy arkusza i uzyskaniu 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 podanym kluczem. |
addDeveloperMetadata(key, visibility) | Sheet | Dodaje do arkusza metadane dewelopera z określonym kluczem. |
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 u dołu bieżącego regionu danych w arkuszu. |
asDataSourceSheet() | DataSourceSheet | Zwraca arkusz jako DataSourceSheet , jeśli jest to typ SheetType.DATASOURCE lub null . |
autoResizeColumn(columnPosition) | Sheet | Ustawia szerokość danej kolumny, aby dopasować ją do jej zawartości. |
autoResizeColumns(startColumn, numColumns) | Sheet | Ustawia szerokość wszystkich kolumn, zaczynając od pozycji kolumny, aby dopasować ją do treści. |
autoResizeRows(startRow, numRows) | Sheet | Ustawia wysokość wszystkich wierszy, które zaczynają się od pozycji danego wiersza, aby dopasować ich zawartość. |
clear() | Sheet | Czyści arkusz i informacje o formatowaniu. |
clear(options) | Sheet | Usuwa arkusz treści lub format zgodnie z opcjami zaawansowanymi. |
clearConditionalFormatRules() | void | Usuwa z arkusza wszystkie reguły formatowania warunkowego. |
clearContents() | Sheet | Usuwa spis treści z zachowaniem formatowania. |
clearFormats() | Sheet | Usuwa arkusz formatowania z zachowaniem treści. |
clearNotes() | Sheet | Usuwa arkusz ze wszystkich notatek. |
collapseAllColumnGroups() | Sheet | Zwija wszystkie grupy kolumn w arkuszu. |
collapseAllRowGroups() | Sheet | Zwija wszystkie grupy wierszy w arkuszu. |
copyTo(spreadsheet) | Sheet | Kopiuje arkusz do danego arkusza kalkulacyjnego, który może być taki sam jak arkusz źródłowy. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Zwraca DeveloperMetadataFinder w celu znalezienia metadanych dewelopera w zakresie tego arkusza. |
createTextFinder(findText) | TextFinder | Tworzy wyszukiwarkę tekstu dla arkusza, który może znaleźć i zastąpić tekst w arkuszu. |
deleteColumn(columnPosition) | Sheet | Usuwa kolumnę w danej pozycji. |
deleteColumns(columnPosition, howMany) | void | Usuwa określoną liczbę kolumn od danej pozycji. |
deleteRow(rowPosition) | Sheet | Usuwa wiersz na danej pozycji. |
deleteRows(rowPosition, howMany) | void | Usuwa określoną liczbę wierszy od podanej pozycji. |
expandAllColumnGroups() | Sheet | Rozwija wszystkie grupy kolumn w arkuszu. |
expandAllRowGroups() | Sheet | Rozwija wszystkie grupy wierszy w arkuszu. |
expandColumnGroupsUpToDepth(groupDepth) | Sheet | Rozwija wszystkie grupy kolumn do określonej głębokości i zwija pozostałe. |
expandRowGroupsUpToDepth(groupDepth) | Sheet | Rozwija wszystkie grupy wierszy do określonej głębokości i zwija 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 null , jeśli nie ma aktywnych zakresów. |
getBandings() | Banding[] | Zwraca wszystkie opaski w tym arkuszu. |
getCharts() | EmbeddedChart[] | Zwraca tablicę wykresów w tym arkuszu. |
getColumnGroup(columnIndex, groupDepth) | Group | Zwraca grupę kolumn dla danego indeksu i głębokości grupy. |
getColumnGroupControlPosition() | GroupControlTogglePosition | Zwraca GroupControlTogglePosition w przypadku wszystkich grup kolumn w arkuszu. |
getColumnGroupDepth(columnIndex) | Integer | Zwraca głębokość grupy w danym indeksie. |
getColumnWidth(columnPosition) | Integer | Pozyskuje szerokość w pikselach danej kolumny. |
getConditionalFormatRules() | ConditionalFormatRule[] | Pobierz wszystkie reguły formatowania warunkowego w tym arkuszu. |
getCurrentCell() | Range | Zwraca aktualną komórkę w aktywnym arkuszu lub null , jeśli nie ma bieżącej komórki. |
getDataRange() | Range | Zwraca wartość Range odpowiadającą wymiarom, przy których występują dane. |
getDataSourceFormulas() | DataSourceFormula[] | Pobiera wszystkie formuły źródła 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 na arkuszu. |
getFilter() | Filter | Zwraca filtr w tym arkuszu lub null , jeśli go nie ma. |
getFormUrl() | String | Zwraca adres URL formularza, który wysyła odpowiedzi do tego arkusza, lub null , jeśli nie ma on powiązanego formularza. |
getFrozenColumns() | Integer | Zwraca liczbę zablokowanych kolumn. |
getFrozenRows() | Integer | Zwraca liczbę zablokowanych wierszy. |
getImages() | OverGridImage[] | Zwraca wszystkie obrazy nad siatką w arkuszu. |
getIndex() | Integer | Pobiera pozycję arkusza w nadrzędnym arkuszu kalkulacyjnym. |
getLastColumn() | Integer | Zwraca pozycję ostatniej kolumny z treścią. |
getLastRow() | Integer | Zwraca pozycję ostatniego wiersza, który zawiera treści. |
getMaxColumns() | Integer | Zwraca bieżącą liczbę kolumn w arkuszu, niezależnie od jego zawartości. |
getMaxRows() | Integer | Zwraca bieżącą liczbę wierszy w arkuszu, niezależnie od jego zawartości. |
getName() | String | Zwraca nazwę arkusza. |
getNamedRanges() | NamedRange[] | Pobiera wszystkie nazwane zakresy w tym arkuszu. |
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ących wszystkie chronione zakresy w arkuszu lub tablicowy element reprezentujący zabezpieczenie w samym arkuszu. |
getRange(row, column) | Range | Zwraca zakres z lewym górnym rzędem przy określonych współrzędnych. |
getRange(row, column, numRows) | Range | Zwraca zakres z lewą górną komórką dla podanych współrzędnych oraz podaną liczbą wierszy. |
getRange(row, column, numRows, numColumns) | Range | Zwraca zakres z lewym górnym rzędem przy danych współrzędnych o określonej liczbie wierszy i kolumn. |
getRange(a1Notation) | Range | Zwraca zakres określony w notacji A1 lub R1C1. |
getRangeList(a1Notations) | RangeList | Zwraca kolekcję RangeList reprezentującą zakresy w tym samym arkuszu określonym przez niepustą listę zapisów A1 lub R1C1. |
getRowGroup(rowIndex, groupDepth) | Group | Zwraca grupę wierszy o danej wartości indeksu i głębokości grupy. |
getRowGroupControlPosition() | GroupControlTogglePosition | Zwraca GroupControlTogglePosition w przypadku wszystkich grup wierszy w arkuszu. |
getRowGroupDepth(rowIndex) | Integer | Zwraca głębokość grupy w danym indeksie. |
getRowHeight(rowPosition) | Integer | Pobiera wysokość w pikselach danego wiersza. |
getSelection() | Selection | Zwraca aktualną wartość Selection w arkuszu kalkulacyjnym. |
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, począwszy od podanych współrzędnych. |
getSlicers() | Slicer[] | Zwraca tablicę fragmentatorów na 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 false . |
hideColumn(column) | void | Ukrywa kolumny w podanym zakresie. |
hideColumns(columnIndex) | void | Ukrywa pojedynczą kolumnę w danym indeksie. |
hideColumns(columnIndex, numColumns) | void | Ukrywa jedną lub kilka kolumn z rzędu od danego indeksu. |
hideRow(row) | void | Ukrywa wiersze w podanym zakresie. |
hideRows(rowIndex) | void | Ukrywa wiersz w danym indeksie. |
hideRows(rowIndex, numRows) | void | Ukrywa jeden lub kilka kolejnych wierszy rozpoczynających się danym indeksem. |
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 określoną pozycją w kolumnie. |
insertColumns(columnIndex) | void | Wstawia pustą kolumnę w arkuszu w określonej lokalizacji. |
insertColumns(columnIndex, numColumns) | void | Wstawia w arkuszu jedną lub kilka kolejnych pustych kolumn, zaczynając od określonej lokalizacji. |
insertColumnsAfter(afterPosition, howMany) | Sheet | Wstawia liczbę kolumn za określoną pozycją kolumny. |
insertColumnsBefore(beforePosition, howMany) | Sheet | Wstawia liczbę kolumn przed daną pozycją w kolumnie. |
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 danym wierszu i kolumnie z przesunięciem pikseli. |
insertImage(url, column, row) | OverGridImage | Wstawia obraz w dokumencie w danym wierszu i kolumnie. |
insertImage(url, column, row, offsetX, offsetY) | OverGridImage | Wstawia obraz w dokumencie w określonym wierszu i w kolumnie z przesunięciem pikseli. |
insertRowAfter(afterPosition) | Sheet | Wstawia wiersz po podanej pozycji. |
insertRowBefore(beforePosition) | Sheet | Wstawia wiersz przed ustaloną pozycją. |
insertRows(rowIndex) | void | Wstawia pusty wiersz w arkuszu w określonej lokalizacji. |
insertRows(rowIndex, numRows) | void | Wstawia jeden lub kilka kolejnych pustych wierszy do arkusza, zaczynając od określonej lokalizacji. |
insertRowsAfter(afterPosition, howMany) | Sheet | Wstawia liczbę wierszy po określonej pozycji w wierszu. |
insertRowsBefore(beforePosition, howMany) | Sheet | Wstawia liczbę wierszy przed daną pozycją w wierszu. |
insertSlicer(range, anchorRowPos, anchorColPos) | Slicer | Dodaje do tego arkusza nowy fragmentator. |
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY) | Slicer | Dodaje do tego arkusza nowy fragmentator. |
isColumnHiddenByUser(columnPosition) | Boolean | Wskazuje, czy dana kolumna jest ukryta przez użytkownika. |
isRightToLeft() | Boolean | Zwraca wartość true , jeśli układ tego arkusza jest od prawej do lewej. |
isRowHiddenByFilter(rowPosition) | Boolean | Wskazuje, czy dany wiersz jest ukryty przez filtr (a nie w widoku filtra). |
isRowHiddenByUser(rowPosition) | Boolean | Wskazuje, czy dany wiersz jest ukryty przez użytkownika. |
isSheetHidden() | Boolean | Zwraca true , jeśli arkusz jest obecnie ukryty. |
moveColumns(columnSpec, destinationIndex) | void | Powoduje przeniesienie kolumn wybranych przez dany zakres do pozycji wskazanej przez destinationIndex . |
moveRows(rowSpec, destinationIndex) | void | Przenosi wiersze wybrane przez dany zakres na pozycję wskazanej przez destinationIndex . |
newChart() | EmbeddedChartBuilder | Zwraca kreator, aby utworzyć nowy wykres dla tego arkusza. |
protect() | Protection | Tworzy obiekt, który może chronić arkusz przed edytowaniem przez użytkowników z odpowiednimi uprawnieniami. |
removeChart(chart) | void | Usuwa wykres z arkusza nadrzędnego. |
setActiveRange(range) | Range | Ustawia w aktywnym arkuszu określony zakres jako active range , przy czym lewa górna komórka w zakresie to current cell . |
setActiveRangeList(rangeList) | RangeList | Ustawia w arkuszu aktywnym określoną listę zakresów jako active ranges . |
setActiveSelection(range) | Range | Ustawia region aktywnego wyboru dla tego arkusza. |
setActiveSelection(a1Notation) | Range | Określa aktywny wybór określony w notacji A1 lub R1C1. |
setColumnGroupControlPosition(position) | Sheet | Ustawia w arkuszu pozycję przełącznika grupy kolumn. |
setColumnWidth(columnPosition, width) | Sheet | Określa szerokość danej kolumny w pikselach. |
setColumnWidths(startColumn, numColumns, width) | Sheet | Określa szerokość określonych kolumn w pikselach. |
setConditionalFormatRules(rules) | void | Zastępuje wszystkie istniejące reguły formatowania warunkowego w arkuszu regułami tekstowymi. |
setCurrentCell(cell) | Range | Ustawia określoną komórkę jako current cell . |
setFrozenColumns(columns) | void | Blokuje określoną liczbę kolumn. |
setFrozenRows(rows) | void | Blokuje określoną liczbę wierszy. |
setHiddenGridlines(hideGridlines) | Sheet | Ukrywa lub ujawnia linie siatki arkusza. |
setName(name) | Sheet | Ustawia nazwę arkusza. |
setRightToLeft(rightToLeft) | Sheet | Ustawia układ arkusza od prawej do lewej lub wyłącza jego ustawienie. |
setRowGroupControlPosition(position) | Sheet | Ustawia pozycję przełącznika sterowania wierszem w arkuszu. |
setRowHeight(rowPosition, height) | Sheet | Ustawia wysokość wiersza w pikselach. |
setRowHeights(startRow, numRows, height) | Sheet | Ustawia wysokość określonych wierszy w pikselach. |
setRowHeightsForced(startRow, numRows, height) | Sheet | Ustawia wysokość określonych wierszy w pikselach. |
setTabColor(color) | Sheet | Ustawia kolor karty arkusza. |
setTabColorObject(color) | Sheet | Ustawia kolor karty arkusza. |
showColumns(columnIndex) | void | Odkrywa kolumnę o podanym indeksie. |
showColumns(columnIndex, numColumns) | void | Pokazuje jedną lub kilka kolejnych kolumn, zaczynając od wskazanego indeksu. |
showRows(rowIndex) | void | Odkrywa wiersz w danym indeksie. |
showRows(rowIndex, numRows) | void | Pokazuje jeden lub więcej kolejnych wierszy rozpoczynających się danym indeksem. |
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 | Pokazuje kolumnę w podanym zakresie. |
unhideRow(row) | void | Pokazuje wiersz z danego zakresu. |
updateChart(chart) | void | Aktualizuje wykres w tym arkuszu. |
Szczegółowa dokumentacja
activate()
Aktywuje ten arkusz. Nie powoduje zmian w samym arkuszu, a jedynie w aktywnym elemencie nadrzędnym.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.activate();
Powrót
Sheet
– nowo aktywny arkusz.
addDeveloperMetadata(key)
Dodaje do arkusza metadane dewelopera z podanym 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 dla nowych metadanych dewelopera. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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.
// 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 dla nowych metadanych dewelopera. |
visibility | DeveloperMetadataVisibility | Widoczność nowych metadanych dewelopera. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Dodaje do arkusza 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 dla nowych metadanych dewelopera. |
value | String | Wartość nowych metadanych dewelopera. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Dodaje do arkusza 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 dla nowych metadanych dewelopera. |
value | String | Wartość nowych metadanych dewelopera. |
visibility | DeveloperMetadataVisibility | Widoczność nowych metadanych dewelopera. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
appendRow(rowContents)
Dodaje wiersz u dołu bieżącego regionu danych w arkuszu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Appends a new row with 3 columns to the bottom of the current // data region in the sheet containing the values in the array. sheet.appendRow(["a man", "a plan", "panama"]);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowContents | Object[] | Tablica wartości do wstawienia po ostatnim wierszu arkusza. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 to typ SheetType.DATASOURCE
lub null
.
// 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());
Powrót
DataSourceSheet
– arkusz źródła danych,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnPosition)
Ustawia szerokość danej kolumny, aby dopasować ją do jej zawartości.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...'); // Sets the first column to a width which fits the text sheet.autoResizeColumn(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja danej kolumny, której rozmiar chcesz zmienić. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumns(startColumn, numColumns)
Ustawia szerokość wszystkich kolumn, zaczynając od pozycji kolumny, aby dopasować ją do treś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 | Pierwsza kolumna, która ma automatycznie zmienić rozmiar. |
numColumns | Integer | Liczba kolumn, których rozmiar automatycznie się zmienia. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeRows(startRow, numRows)
Ustawia wysokość wszystkich wierszy, które zaczynają się od pozycji danego wiersza, aby dopasować ich zawartość.
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 zmiany rozmiaru. |
numRows | Integer | Liczba wierszy, których rozmiar ma być zmieniany automatycznie. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Czyści arkusz i informacje o formatowaniu.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clear();
Powrót
Sheet
– usunięty arkusz.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Usuwa arkusz treści lub format zgodnie z 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 opcje zaawansowane wymienione poniżej. |
Parametry zaawansowane
Nazwa | Typ | Opis |
---|---|---|
contentsOnly | Boolean | Czy usunąć treści. |
formatOnly | Boolean | Określa, czy chcesz wyczyścić format. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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. Odpowiada to wywołaniu funkcji setConditionalFormatRules(rules)
z pustą tablicą jako danych wejściowych.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.clearConditionalFormatRules();
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContents()
Usuwa spis treści z zachowaniem formatowania.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearContents();
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormats()
Usuwa arkusz formatowania z zachowaniem treści.
Formatowanie odnosi się do formatowania danych zgodnie z wyborami dostępnymi w menu „Format” (np. pogrubienie, kursywa, formatowanie warunkowe), a nie szerokości i wysokości komórek.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearFormats();
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNotes()
Usuwa arkusz ze wszystkich notatek.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearNotes();
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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();
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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();
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(spreadsheet)
Kopiuje arkusz do danego arkusza kalkulacyjnego, który może być taki sam jak 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 być taki sam jak arkusz źródłowy. |
Powrót
Sheet
– nowy arkusz używany do tworzenia łańcuchów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Zwraca DeveloperMetadataFinder
w celu znalezienia metadanych dewelopera w zakresie tego arkusza. Metadane znajdują się w zakresie danego 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());
Powrót
DeveloperMetadataFinder
– narzędzie do wyszukiwania metadanych dla deweloperów, które umożliwia wyszukiwanie metadanych z zakresu tego arkusza.
createTextFinder(findText)
Tworzy wyszukiwarkę tekstu dla arkusza, który może znaleźć i zastąpić 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. |
Powrót
TextFinder
– pole TextFinder
w arkuszu.
deleteColumn(columnPosition)
Usuwa kolumnę w danej pozycji.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja kolumny, począwszy od 1 w pierwszej kolumnie. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
Usuwa określoną liczbę kolumn od danej pozycji.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja pierwszej kolumny do usunięcia. |
howMany | Integer | Liczba kolumn do usunięcia. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRow(rowPosition)
Usuwa wiersz na danej pozycji.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first row sheet.deleteRow(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja wiersza, zaczynająca się od 1 w pierwszym wierszu. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
Usuwa określoną liczbę wierszy od podanej pozycji.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja pierwszego wiersza do usunięcia. |
howMany | Integer | Liczba wierszy do usunięcia. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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();
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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();
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandColumnGroupsUpToDepth(groupDepth)
Rozwija wszystkie grupy kolumn do określonej głębokości i zwija 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 mają się rozwijać grupy kolumn. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandRowGroupsUpToDepth(groupDepth)
Rozwija wszystkie grupy wierszy do określonej głębokości i zwija 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 mają się rozwijać grupy wierszy. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveCell()
Zwraca aktywną komórkę w tym arkuszu.
Uwaga: najlepiej jest użyć symbolu getCurrentCell()
, który zwraca zaznaczoną komórkę.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
Powrót
Range
– bieżąca aktywna komórka,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveRange()
Zwraca wybrany zakres w aktywnym arkuszu lub null
, jeśli nie ma aktywnego zakresu. Jeśli wybierzesz wiele zakresów, ta metoda zwróci tylko ostatni wybrany zakres.
Termin „zakres aktywny” odnosi się do zakresu wybranego przez użytkownika w aktywnym arkuszu, a w funkcji niestandardowej odnosi się do komórki, która jest aktywnie przeliczana.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
Powrót
Range
– aktywny zakres
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 null
, jeśli nie ma aktywnych zakresów.
Jeśli został wybrany jeden zakres, działa to jak wywołanie getActiveRange()
.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Powrót
RangeList
– lista aktywnych zakresów,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Zobacz też
getBandings()
Zwraca wszystkie opaski 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()); }
Powrót
Banding[]
– wszystkie pasma w tym arkuszu.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCharts()
Zwraca tablicę wykresów w tym arkuszu.
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 }
Powrót
EmbeddedChart[]
– tablica wykresów.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroup(columnIndex, groupDepth)
Zwraca grupę kolumn dla danego indeksu 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 sterowania grupą lub indeks w grupie. |
groupDepth | Integer | Głębokość grupy. |
Powrót
Group
– grupa kolumn w indeksie kontrolnym i na podstawie głębokości lub, jeśli grupa nie istnieje, zwraca wyjątek.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupControlPosition()
Zwraca GroupControlTogglePosition
w przypadku 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();
Powrót
GroupControlTogglePosition
– true
, jeśli przełącznik grupowania kolumn jest widoczny za grupą w tym arkuszu, a w przeciwnym razie – false
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupDepth(columnIndex)
Zwraca głębokość grupy w danym indeksie.
Głębokość grupy wskazuje, które grupy nakładają się na kolumnę. Wartość musi 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. |
Powrót
Integer
– głębokość grupy w danym indeksie,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnWidth(columnPosition)
Pozyskuje szerokość w pikselach danej kolumny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja kolumny do sprawdzenia. |
Powrót
Integer
– szerokość kolumny w pikselach,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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); }
Powrót
ConditionalFormatRule[]
– tablica wszystkich reguł w arkuszu,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCurrentCell()
Zwraca aktualną komórkę w aktywnym arkuszu lub null
, jeśli nie ma bieżącej komórki. Bieżąca komórka to komórka, która jest zaznaczona w interfejsie Arkuszy Google i jest wyróżniona ciemnym obramowaniem. Obecna komórka nie ma więcej niż 1 komórki. Gdy użytkownik zaznaczy co najmniej 1 zakres komórek, jedną z zaznaczonych komórek będzie komórka bieżąca.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
Powrót
Range
– bieżąca komórka,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRange()
Zwraca wartość Range
odpowiadającą wymiarom, przy których występują dane.
Jest to funkcja odpowiednia do utworzenia zakresu ograniczonego przez A1 i (Sheet.getLastColumn(), Sheet.getLastRow()).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This represents ALL the data var range = sheet.getDataRange(); var values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (var i = 0; i < values.length; i++) { var row = ""; for (var j = 0; j < values[i].length; j++) { if (values[i][j]) { row = row + values[i][j]; } row = row + ","; } Logger.log(row); }
Powrót
Range
– zakres obejmujący wszystkie dane z arkusza kalkulacyjnego
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Pobiera wszystkie formuły źródła danych.
Powrót
DataSourceFormula[]
– lista formuł źródeł danych.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
Pobiera wszystkie tabele przestawne źródła danych.
Powrót
DataSourcePivotTable[]
– lista tabel przestawnych źródeł danych,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
Pobiera wszystkie tabele źródeł danych.
Powrót
DataSourceTable[]
– lista tabel źródeł danych,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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()); }
Powrót
DeveloperMetadata[]
– metadane dewelopera powiązane z tym arkuszem.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDrawings()
Zwraca tablicę rysunków na 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);
Powrót
Drawing[]
– lista rysunków w tym arkuszu,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 go nie ma.
// Gets the filter on the active sheet. let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter();
Powrót
Filter
– filtr.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 nie ma on powiązanego formularza.
var sheet = SpreadsheetApp.getActiveSheet(); var url = sheet.getFormUrl();
Powrót
String
– adres URL formularza, który umieszcza odpowiedzi w tym arkuszu, lub plik null
, jeśli nie ma on powiązanego formularza.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenColumns()
Zwraca liczbę zablokowanych kolumn.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
Powrót
Integer
– liczba zablokowanych kolumn,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenRows()
Zwraca liczbę zablokowanych wierszy.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
Powrót
Integer
– liczba zablokowanych wierszy,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getImages()
Zwraca wszystkie obrazy nad siatką w arkuszu.
Powrót
OverGridImage[]
– tablica obrazów nad siatką.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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ę od 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());
Powrót
Integer
– położenie arkusza w jego nadrzędnym arkuszu kalkulacyjnym,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
Zwraca pozycję ostatniej kolumny z treścią.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Powrót
Integer
– ostatnia kolumna arkusza z treścią
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
Zwraca pozycję ostatniego wiersza, który zawiera treści.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Powrót
Integer
– ostatni wiersz arkusza z treścią
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxColumns()
Zwraca bieżącą liczbę kolumn w arkuszu, niezależnie od jego zawartości.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxColumns());
Powrót
Integer
– maksymalna szerokość arkusza.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxRows()
Zwraca bieżącą liczbę wierszy w arkuszu, niezależnie od jego zawartości.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxRows());
Powrót
Integer
– maksymalna wysokość arkusza.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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());
Powrót
String
– nazwa arkusza;
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNamedRanges()
Pobiera wszystkie nazwane zakresy w tym arkuszu.
// 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()); }
Powrót
NamedRange[]
– tablica ze wszystkimi nazwanymi zakresami w arkuszu,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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();
Powrót
Spreadsheet
– nadrzędny arkusz kalkulacyjny.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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()); }
Powrót
PivotTable[]
– tabele przestawne w tym arkuszu,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getProtections(type)
Pobiera tablicę obiektów reprezentujących wszystkie chronione zakresy w arkuszu lub tablicowy element reprezentujący zabezpieczenie 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 . |
Powrót
Protection[]
– tablica obiektów reprezentujących wszystkie chronione zakresy w arkuszu lub tablica jednoelementowa symbolizująca zabezpieczenie w samym arkuszu.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column)
Zwraca zakres z lewym górnym rzędem przy określonych 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 zaczyna się od cyfry 1. |
column | Integer | Indeks kolumny komórki do zwrócenia. Indeksowanie kolumny rozpoczyna się od cyfry 1. |
Powrót
Range
– zakres zawierający tylko tę komórkę.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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ą dla podanych współrzędnych oraz 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 wiersza początkowego zakresu. Indeksowanie wierszy zaczyna się od cyfry 1. |
column | Integer | Indeks kolumny zakresu. Indeksowanie kolumn rozpoczyna się od 1. |
numRows | Integer | Liczba wierszy do zwrócenia. |
Powrót
Range
– zakres zawierający jedną kolumnę danych z określoną liczbą wierszy;
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 lewym górnym rzędem przy danych współrzędnych o określonej liczbie 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 wiersza początkowego zakresu. Indeksowanie wierszy zaczyna się od cyfry 1. |
column | Integer | Indeks kolumny początkowej zakresu. Indeksowanie kolumn rozpoczyna się od 1. |
numRows | Integer | Liczba wierszy do zwrócenia. |
numColumns | Integer | Liczba kolumn do zwrócenia. |
Powrót
Range
– zakres odpowiadający wskazanemu obszarowi.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(a1Notation)
Zwraca zakres określony w notacji A1 lub 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 zwracany w notacji A1 lub R1C1. |
Powrót
Range
– zakres w lokalizacji wyznaczonej
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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ślonym przez niepustą listę zapisów A1 lub 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 zapisem A1 lub R1C1. |
Powrót
RangeList
– lista zakresów w wyznaczonej lokalizacji.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroup(rowIndex, groupDepth)
Zwraca grupę wierszy o danej wartości indeksu 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 sterowania grupą lub indeks w grupie. |
groupDepth | Integer | Głębokość grupy. |
Powrót
Group
– grupa wierszy na podstawie indeksu kontrolnego i głębokości lub, jeśli nie istnieje grupa, zwraca wyjątek.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupControlPosition()
Zwraca 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();
Powrót
GroupControlTogglePosition
– true
, jeśli przełącznik grupy pogrupowania wierszy jest widoczny za grupą w tym arkuszu, lub false
w innym przypadku.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupDepth(rowIndex)
Zwraca głębokość grupy w danym indeksie.
Głębokość grupy wskazuje, które grupy nakładają się na wiersz. Wartość musi 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. |
Powrót
Integer
– głębokość grupy w danym indeksie.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowHeight(rowPosition)
Pobiera wysokość w pikselach danego wiersza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja wiersza do sprawdzenia. |
Powrót
Integer
– wysokość wiersza w pikselach,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
Zwraca aktualną wartość Selection
w arkuszu kalkulacyjnym.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Powrót
Selection
– bieżący wybór
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 unikalny identyfikator arkusza kalkulacyjnego. Identyfikator jest monotonicznie rosnącą liczbą całkowitą przypisywaną podczas tworzenia arkusza niezależnie od pozycji arkusza. Jest to przydatne w połączeniu z takimi metodami jak Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
, które zamiast parametru Sheet
stosują parametr gridId
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Powrót
Integer
– identyfikator arkusza unikalny dla arkusza kalkulacyjnego.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetName()
Zwraca nazwę arkusza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Powrót
String
– nazwa arkusza;
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(startRow, startColumn, numRows, numColumns)
Zwraca prostokątną siatkę wartości dla tego zakresu, począwszy od podanych współrzędnych. Wartość -1 podana jako pozycja w wierszu lub kolumnie odpowiada odpowiednikowi ostatniego wiersza lub kolumny z danymi w arkuszu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startRow | Integer | Pozycja wiersza początkowego. |
startColumn | Integer | Pozycja kolumny początkowej. |
numRows | Integer | Liczba wierszy, dla których mają być zwracane wartości. |
numColumns | Integer | Liczba kolumn, dla których zostaną zwrócone wartości. |
Powrót
Object[][]
– dwuwymiarowa tablica wartości,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSlicers()
Zwraca tablicę fragmentatorów na 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()); }
Powrót
Slicer[]
– lista fragmentatorów w tym arkuszu,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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();
Powrót
Color
– kolor karty arkusza lub null
, jeśli karta arkusza nie ma koloru.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 pojedynczy umieszczony obiekt, taki jak EmbeddedChart
, jest arkuszem SheetType.OBJECT
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getType());
Powrót
SheetType
– typ arkusza,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 false
.
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());
Powrót
Boolean
– true
, jeśli linie siatki są ukryte; w przeciwnym razie false
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
Ukrywa kolumny w podanym 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 za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex)
Ukrywa pojedynczą kolumnę w danym indeksie. W przypadku tej metody użyj indeksu 1.
Aby ukryć więcej niż 1 kolumnę za pomocą indeksu, użyj hideColumns(columnIndex, numColumns)
.
Aby ukryć więcej niż 1 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 za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex, numColumns)
Ukrywa jedną lub kilka kolumn z rzędu od danego indeksu. W przypadku tej metody użyj 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 | Początkowy indeks kolumn do ukrycia. |
numColumns | Integer | Liczba kolumn do ukrycia. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRow(row)
Ukrywa wiersze w podanym 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 za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex)
Ukrywa wiersz w danym 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 za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex, numRows)
Ukrywa jeden lub kilka kolejnych wierszy rozpoczynających się danym indeksem.
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 za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideSheet()
Ukrywa ten arkusz. Jeśli arkusz jest już ukryty, nie ma żadnego efektu. Jeśli ta metoda jest wywoływana w jedynym widocznym arkuszu, zwraca wyjątek.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.hideSheet();
Powrót
Sheet
– bieżący arkusz.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 za pomocą co najmniej jednego 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ę. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
Wstawia kolumnę przed określoną pozycją w kolumnie.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
beforePosition | Integer | Kolumna, przed którą należy dodać nową kolumnę. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 wstawić kolumnę. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex, numColumns)
Wstawia w arkuszu jedną lub kilka kolejnych pustych kolumn, 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 wstawić kolumnę. |
numColumns | Integer | Liczba kolumn do wstawienia. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsAfter(afterPosition, howMany)
Wstawia liczbę kolumn za określoną pozycją kolumny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the second column position sheet.insertColumnsAfter(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
afterPosition | Integer | Kolumna, po której należy dodać nową kolumnę. |
howMany | Integer | Liczba kolumn do wstawienia. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsBefore(beforePosition, howMany)
Wstawia liczbę kolumn przed daną pozycją w kolumnie.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
Parametry
Nazwa | Typ | Opis |
---|---|---|
beforePosition | Integer | Kolumna, przed którą należy dodać nową kolumnę. |
howMany | Integer | Liczba kolumn do wstawienia. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row)
Wstawia BlobSource
jako obraz w dokumencie w danym wierszu i kolumnie. Rozmiar obrazu jest pobierany z zawartości bloba. Maksymalny obsługiwany rozmiar bloba to 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
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. |
Powrót
OverGridImage
– wstawiony obraz.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row, offsetX, offsetY)
Wstawia BlobSource
jako obraz w dokumencie w danym wierszu i kolumnie z przesunięciem pikseli. Rozmiar obrazu jest pobierany z zawartości bloba. Maksymalny obsługiwany rozmiar bloba to 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Obiekt blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę. |
column | Integer | Pozycja kolumny. |
row | Integer | Pozycja wiersza. |
offsetX | Integer | Przesunięcie w poziomie od rogu komórki w pikselach. |
offsetY | Integer | Przesunięcie w pionie od rogu komórki w pikselach. |
Powrót
OverGridImage
– wstawiony obraz.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row)
Wstawia obraz w dokumencie w danym wierszu i kolumnie.
Podany URL musi być dostępny publicznie.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL obrazu. |
column | Integer | Pozycja kolumny siatki. |
row | Integer | Pozycja wiersza siatki. |
Powrót
OverGridImage
– wstawiony obraz.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row, offsetX, offsetY)
Wstawia obraz w dokumencie w określonym wierszu i w kolumnie z przesunięciem pikseli.
Podany URL musi być dostępny publicznie.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL obrazu. |
column | Integer | Pozycja kolumny. |
row | Integer | Pozycja wiersza. |
offsetX | Integer | Przesunięcie w poziomie od rogu komórki w pikselach. |
offsetY | Integer | Przesunięcie w pionie od rogu komórki w pikselach. |
Powrót
OverGridImage
– wstawiony obraz.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowAfter(afterPosition)
Wstawia wiersz po podanej pozycji.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
afterPosition | Integer | Wiersz, po którym dodaj nowy wiersz. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowBefore(beforePosition)
Wstawia wiersz przed ustaloną pozycją.
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 chcesz dodać nowy wiersz. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 wstawić wiersz. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex, numRows)
Wstawia jeden lub kilka kolejnych pustych wierszy do arkusza, 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 wstawić wiersz. |
numRows | Integer | Liczba wierszy do wstawienia. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsAfter(afterPosition, howMany)
Wstawia liczbę wierszy po określonej pozycji w wierszu.
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, do którego chcesz dodać nowe wiersze. |
howMany | Integer | Liczba wierszy do wstawienia. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsBefore(beforePosition, howMany)
Wstawia liczbę wierszy przed daną pozycją w wierszu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
Parametry
Nazwa | Typ | Opis |
---|---|---|
beforePosition | Integer | Wiersz, przed którym chcesz dodać nowe wiersze. |
howMany | Integer | Liczba wierszy do wstawienia. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos)
Dodaje do tego arkusza nowy fragmentator.
// 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 zostanie utworzony fragmentator. |
anchorRowPos | Integer | Górna część fragmentatora jest zakotwiczona w tym wierszu. |
anchorColPos | Integer | Górna strona fragmentatora jest zakotwiczona w tej kolumnie. |
Powrót
Slicer
– nowo wstawiony fragmentator.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)
Dodaje do tego arkusza nowy fragmentator.
// 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 zostanie utworzony fragmentator. |
anchorRowPos | Integer | Górna część fragmentatora jest zakotwiczona w tym wierszu. |
anchorColPos | Integer | Górna strona fragmentatora jest zakotwiczona w tej kolumnie. |
offsetX | Integer | Przesunięcie w poziomie od rogu komórki w pikselach. |
offsetY | Integer | Przesunięcie w pionie od rogu komórki w pikselach. |
Powrót
Slicer
– nowo wstawiony fragmentator.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isColumnHiddenByUser(columnPosition)
Wskazuje, czy dana kolumna jest ukryta przez użytkownika.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.isColumnHiddenByUser(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja kolumny do sprawdzenia. |
Powrót
Boolean
– true
, jeśli kolumna jest ukryta. W przeciwnym razie false
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 tego arkusza jest od prawej do lewej. Zwraca 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());
Powrót
Boolean
– true
, jeśli czyta od prawej do lewej – false
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByFilter(rowPosition)
Wskazuje, czy dany wiersz jest ukryty przez filtr (a nie w widoku filtra).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja wiersza do sprawdzenia. |
Powrót
Boolean
– true
, jeśli wiersz jest ukryty, w przeciwnym razie – false
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByUser(rowPosition)
Wskazuje, czy dany wiersz jest ukryty przez użytkownika.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByUser(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja wiersza do sprawdzenia. |
Powrót
Boolean
– true
, jeśli wiersz jest ukryty, w przeciwnym razie – false
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isSheetHidden()
Zwraca true
, jeśli arkusz jest obecnie ukryty.
var sheet = SpreadsheetApp.getActiveSheet(); if (sheet.isSheetHidden()) { // do something... }
Powrót
Boolean
– true
, jeśli arkusz jest ukryty. W przeciwnym razie false
.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveColumns(columnSpec, destinationIndex)
Powoduje przeniesienie kolumn wybranych przez dany zakres do pozycji wskazanej przez destinationIndex
. Sama kolumna columnSpec
nie musi dokładnie odzwierciedlać całej kolumny lub grupy kolumn, ponieważ ma do niej wybrać wszystkie kolumny z zakresu.
// 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 powinny zostać przeniesione. |
destinationIndex | Integer | Indeks, do którego należy przenieść kolumny. Pamiętaj, że ten indeks zależy od współrzędnych, zanim kolumny zostaną przeniesione. Istniejące dane zostaną przesunięte w prawo, aby zrobić miejsce na przeniesione kolumny, a kolumny źródłowe zostaną usunięte z siatki. W rezultacie dane mogą się znajdować w innym indeksie niż pierwotnie określono. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveRows(rowSpec, destinationIndex)
Przenosi wiersze wybrane przez dany zakres na pozycję wskazanej przez destinationIndex
. Sama właściwość rowSpec
nie musi dokładnie odzwierciedlać całego wiersza lub grupy wierszy do przeniesienia – wybiera wszystkie wiersze w zakresie.
// 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 należy przenieść wiersze. Indeks jest oparty na współrzędnych, zanim wiersze zostaną przeniesione. Istniejące dane są przesunięcie w dół, aby zrobić miejsce na przeniesione wiersze, podczas gdy wiersze źródłowe są usuwane z siatki. W rezultacie dane mogą się znajdować w innym indeksie niż pierwotnie określono. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
newChart()
Zwraca kreator, aby utworzyć nowy wykres dla tego arkusza.
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());
Powrót
EmbeddedChartBuilder
– narzędzie do tworzenia nowych wykresów,
protect()
Tworzy obiekt, który może chronić arkusz przed edytowaniem przez użytkowników z odpowiednimi uprawnieniami. Dopóki skrypt nie zmieni listy edytorów arkusza (wywołania funkcji Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
lub ustawienia nowej wartości elementu Protection.setDomainEdit(editable)
), uprawnienia nie są powielane przez sam arkusz kalkulacyjny, co oznacza, że arkusz pozostaje niezabezpieczony. Jeśli arkusz jest już chroniony, ta metoda zwraca obiekt reprezentujący istniejące ustawienia zabezpieczeń.
Chroniony arkusz może zawierać regiony niechronione.
// 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); }
Powrót
Protection
– obiekt reprezentujący ustawienia zabezpieczeń;
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRange(range)
Ustawia w aktywnym arkuszu określony zakres jako active range
, przy czym 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, który ma być ustawiony jako aktywny. |
Powrót
Range
– nowo aktywny zakres
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRangeList(rangeList)
Ustawia w arkuszu aktywnym określoną listę zakresów jako active ranges
. Ostatni zakres na liście jest ustawiony jako 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. |
Powrót
RangeList
– nowo wybrana lista zakresów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(range)
Ustawia region aktywnego wyboru dla tego arkusza.
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, który ma być ustawiony jako aktywny. |
Powrót
Range
– nowo aktywny zakres
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(a1Notation)
Określa aktywny wybór określony w notacji A1 lub R1C1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.setActiveSelection("A1:D4");
Parametry
Nazwa | Typ | Opis |
---|---|---|
a1Notation | String | Zakres, który zostanie ustawiony jako aktywny, zgodnie z zapisem A1 lub zapisem R1C1. |
Powrót
Range
– nowo aktywny zakres
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnGroupControlPosition(position)
Ustawia w arkuszu pozycję przełącznika grupy kolumn.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setColumnGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
Parametry
Nazwa | Typ | Opis |
---|---|---|
position | GroupControlTogglePosition | Pozycja przełącznika grupy kolumn. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidth(columnPosition, width)
Określa szerokość danej kolumny w pikselach.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first column to a width of 200 pixels sheet.setColumnWidth(1, 200);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja kolumny do ustawienia. |
width | Integer | Szerokość w pikselach, w jakiej ma być ustawiona. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidths(startColumn, numColumns, width)
Określa szerokość określonych 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 w kolumnie początkowej, którą chcesz zmienić. |
numColumns | Integer | Liczba kolumn do zmiany. |
width | Integer | Szerokość w pikselach, w jakiej ma być ustawiona. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 tekstowymi. Reguły są sprawdzane w kolejności ich wprowadzania.
// 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 za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setCurrentCell(cell)
Ustawia określoną komórkę jako current cell
.
Jeśli podana komórka występuje w już wybranym zakresie, staje się on zakresem aktywnym, w którym komórka jest bieżącą.
Jeśli określonej komórki nie ma w wybranym zakresie, zaznaczenie jest usuwane, a komórka staje się bieżącą i aktywnym zakresem.
Uwaga: określony Range
musi składać się z jednej komórki. W przeciwnym razie zwróci wyjątek.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Parametry
Nazwa | Typ | Opis |
---|---|---|
cell | Range | Komórka ustawiona jako bieżąca komórka. |
Powrót
Range
– nowo ustawiona komórka
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenColumns(columns)
Blokuje określoną liczbę kolumn. Jeśli wartość wynosi 0, ż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 za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenRows(rows)
Blokuje określoną liczbę wierszy. Jeśli liczba wynosi 0, żadne wiersze nie są zablokowane.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first row sheet.setFrozenRows(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rows | Integer | Liczba wierszy do zablokowania. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHiddenGridlines(hideGridlines)
Ukrywa lub ujawnia linie siatki arkusza.
// 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 true , ukryj linie siatki w tym arkuszu. W przeciwnym razie wyświetl linie siatki. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
Ustawia 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. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRightToLeft(rightToLeft)
Ustawia układ arkusza od prawej do lewej lub wyłącza jego ustawienie.
// 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 układ true jest ustawiony na układ od prawej do lewej, komórka A1 w prawym górnym rogu. Jeśli układ false jest ustawiony jako domyślny, od lewej do prawej (w lewym górnym rogu komórki A1). |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowGroupControlPosition(position)
Ustawia pozycję przełącznika sterowania wierszem w arkuszu.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
Parametry
Nazwa | Typ | Opis |
---|---|---|
position | GroupControlTogglePosition | Pozycja przełącznika grupy wierszy. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeight(rowPosition, height)
Ustawia wysokość wiersza w pikselach. Domyślnie wiersze powiększają się, aby dopasować się do zawartości komórki. Jeśli chcesz wymusić wiersze na 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, która ma zostać zmieniona. |
height | Integer | Wysokość w pikselach, w jakiej ma zostać ustawiona. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeights(startRow, numRows, height)
Ustawia wysokość określonych wierszy w pikselach. Domyślnie wiersze powiększają się, aby dopasować się do zawartości komórki. Jeśli chcesz wymusić wiersze do określonej wysokości, użyj 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 w wierszu początkowym, który chcesz zmienić. |
numRows | Integer | Liczba wierszy do zmiany. |
height | Integer | Wysokość w pikselach, w jakiej ma zostać ustawiona. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeightsForced(startRow, numRows, height)
Ustawia wysokość określonych wierszy w pikselach. Domyślnie wiersze powiększają się, aby dopasować się do zawartości komórki. Gdy używasz setRowHeightsForced
, wiersze są wymuszane do określonej wysokości, 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 w wierszu początkowym, który chcesz zmienić. |
numRows | Integer | Liczba wierszy do zmiany. |
height | Integer | Wysokość w pikselach, w jakiej ma zostać ustawiona. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 (taki jak '#ffffff' lub 'white' ) lub null , aby zresetować kolor karty. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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. |
Powrót
Sheet
– ten arkusz do łańcucha.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex)
Odkrywa kolumnę o podanym 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 za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex, numColumns)
Pokazuje jedną lub kilka kolejnych kolumn, zaczynając od wskazanego 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 | Początkowy indeks kolumn do odkrycia. |
numColumns | Integer | Liczba kolumn do odkrycia. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex, numRows)
Pokazuje jeden lub więcej kolejnych wierszy rozpoczynających się danym indeksem.
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 za pomocą co najmniej jednego 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 ma żadnego efektu.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.showSheet();
Powrót
Sheet
– bieżący arkusz.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 do sortowania. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition, ascending)
Sortuje arkusz według kolumny. Pobiera parametr, aby określić rosnąco lub malejąco
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Kolumna do sortowania. |
ascending | Boolean | true – sortowanie rosnące, false – sortowanie malejąco. |
Powrót
Sheet
– arkusz przydatny do łańcucha metod
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideColumn(column)
Pokazuje kolumnę w podanym zakresie.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideColumn(range);
Parametry
Nazwa | Typ | Opis |
---|---|---|
column | Range | Zakres, jeśli jest ukryty. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideRow(row)
Pokazuje wiersz z danego zakresu.
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, jeśli jest ukryty. |
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji za pomocą co najmniej jednego 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 za pomocą co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets