uzyskiwać dostępu do arkuszy kalkulacyjnych i modyfikować je; Typowe operacje to zmiana nazwy arkusza i uzyskanie dostępu do zakresu obiekty z arkusza.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
activate() | Sheet | Aktywuje ten arkusz. |
addDeveloperMetadata(key) | Sheet | Dodaje do arkusza metadane dewelopera o określonym kluczu. |
addDeveloperMetadata(key, visibility) | Sheet | Dodaje do arkusza metadane dewelopera o określonym kluczu i widoczności. |
addDeveloperMetadata(key, value) | Sheet | Dodaje do arkusza metadane dewelopera o określonym kluczu i wartości. |
addDeveloperMetadata(key, value, visibility) | Sheet | Dodaje do arkusza metadane dewelopera o określonym kluczu, wartości i widoczności. |
appendRow(rowContents) | Sheet | Dodaje wiersz na dole bieżącego regionu danych w arkuszu. |
asDataSourceSheet() | DataSourceSheet | Zwraca arkusz jako DataSourceSheet , jeśli jest typu SheetType.DATASOURCE . W przeciwnym razie zwraca null . |
autoResizeColumn(columnPosition) | Sheet | Ustawia szerokość danej kolumny zgodnie z jej zawartością. |
autoResizeColumns(startColumn, numColumns) | Sheet | Ustawia szerokość wszystkich kolumn, zaczynając od danej pozycji, aby pasowała do zawartości. |
autoResizeRows(startRow, numRows) | Sheet | Ustawia wysokość wszystkich wierszy, zaczynając od danej pozycji, aby dopasować je do zawartości. |
clear() | Sheet | Usuwa zawartość arkusza z informacjami o formatowaniu. |
clear(options) | Sheet | Czyści arkusz treści i/lub format zgodnie z podanymi opcjami zaawansowanymi. |
clearConditionalFormatRules() | void | Usuwa z arkusza wszystkie reguły formatowania warunkowego. |
clearContents() | Sheet | Czyści arkusz treści, zachowując informacje o formatowaniu. |
clearFormats() | Sheet | Czyści arkusz formatowania, zachowując treść. |
clearNotes() | Sheet | Czyści arkusz 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ć tym samym arkuszem źródłowym. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Zwraca DeveloperMetadataFinder w przypadku znalezienia metadanych dewelopera w zakresie
ten arkusz. |
createTextFinder(findText) | TextFinder | Tworzy wyszukiwarkę tekstu dla arkusza, która może znajdować i zastępować tekst w arkuszu. |
deleteColumn(columnPosition) | Sheet | Usuwa kolumnę na podanej pozycji. |
deleteColumns(columnPosition, howMany) | void | Usuwa określoną liczbę kolumn, zaczynając od danej pozycji. |
deleteRow(rowPosition) | Sheet | Usuwa wiersz na danej pozycji. |
deleteRows(rowPosition, howMany) | void | Usuwa liczbę wierszy, zaczynając od danej 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 danej głębokości i zwija wszystkie pozostałe. |
expandRowGroupsUpToDepth(groupDepth) | Sheet | Rozwija wszystkie grupy wierszy do danej głębokości i zwija wszystkie pozostałe. |
getActiveCell() | Range | Zwraca aktywną komórkę w tym arkuszu. |
getActiveRange() | Range | Zwraca wybrany zakres w aktywnym arkuszu lub null , jeśli nie ma aktywnego zakresu. |
getActiveRangeList() | RangeList | Zwraca listę aktywnych zakresów w aktywnym arkuszu lub null , jeśli nie ma żadnych aktywnych zakresów
zakresów. |
getBandings() | Banding[] | Zwraca wszystkie pasma w tym arkuszu. |
getCharts() | EmbeddedChart[] | Zwraca tablicę wykresów z tego arkusza. |
getColumnGroup(columnIndex, groupDepth) | Group | Zwraca grupę kolumn o danym indeksie i głębokości grupy. |
getColumnGroupControlPosition() | GroupControlTogglePosition | Zwraca GroupControlTogglePosition dla wszystkich grup kolumn w arkuszu. |
getColumnGroupDepth(columnIndex) | Integer | Zwraca głębokość grupy dla kolumny o podanym indeksie. |
getColumnWidth(columnPosition) | Integer | Pobiera szerokość danej kolumny w pikselach. |
getConditionalFormatRules() | ConditionalFormatRule[] | Pobierz wszystkie reguły formatowania warunkowego z tego arkusza. |
getCurrentCell() | Range | Zwraca bieżącą komórkę w aktywnym arkuszu lub null , jeśli nie ma bieżącej komórki. |
getDataRange() | Range | Zwraca wartość Range odpowiadającą wymiarom, w których znajdują się 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 w arkuszu. |
getFilter() | Filter | Zwraca filtr w danym arkuszu lub null , jeśli nie ma filtra. |
getFormUrl() | String | Zwraca adres URL formularza, który wysyła odpowiedzi do tego arkusza, lub null , jeśli ta funkcja
arkusz nie ma powiązanego formularza. |
getFrozenColumns() | Integer | Zwraca liczbę zablokowanych kolumn. |
getFrozenRows() | Integer | Zwraca liczbę zablokowanych wierszy. |
getImages() | OverGridImage[] | Zwraca wszystkie obrazy w arkuszu. |
getIndex() | Integer | Pobiera pozycję arkusza w jego arkuszu kalkulacyjnym nadrzędnym. |
getLastColumn() | Integer | Zwraca pozycję ostatniej kolumny, która zawiera treść. |
getLastRow() | Integer | Zwraca pozycję ostatniego wiersza, który zawiera treść. |
getMaxColumns() | Integer | Zwraca bieżącą liczbę kolumn w arkuszu niezależnie od treści. |
getMaxRows() | Integer | Zwraca bieżącą liczbę wierszy w arkuszu niezależnie od zawartości. |
getName() | String | Zwraca nazwę arkusza. |
getNamedRanges() | NamedRange[] | Pobiera wszystkie nazwane zakresy z tego arkusza. |
getParent() | Spreadsheet | Zwraca kolumnę Spreadsheet , która zawiera ten arkusz. |
getPivotTables() | PivotTable[] | Zwraca wszystkie tabele przestawne z tego arkusza. |
getProtections(type) | Protection[] | Pobiera tablicę obiektów reprezentujących wszystkie zakresy chronione w arkuszu lub jeden element reprezentującą zabezpieczenie w samym arkuszu. |
getRange(row, column) | Range | Zwraca zakres z lewą górną komórką przy podanych współrzędnych. |
getRange(row, column, numRows) | Range | Zwraca zakres z lewą górną komórką pod podanymi współrzędnymi i z podaną liczbą wierszy. |
getRange(row, column, numRows, numColumns) | Range | Zwraca zakres z lewej górnej komórki przy podanych współrzędnych i podanej liczby wierszy i kolumny. |
getRange(a1Notation) | Range | Zwraca zakres podany w notacji A1 lub R1C1. |
getRangeList(a1Notations) | RangeList | Zwraca kolekcję RangeList reprezentującą zakresy w tym samym określonym arkuszu
na niepustą listę notacji A1 lub R1C1. |
getRowGroup(rowIndex, groupDepth) | Group | Zwraca grupę wierszy o danym indeksie i głębokości grupy. |
getRowGroupControlPosition() | GroupControlTogglePosition | Zwraca GroupControlTogglePosition dla wszystkich grup wierszy w arkuszu. |
getRowGroupDepth(rowIndex) | Integer | Zwraca głębokość grupy wiersza o danym indeksie. |
getRowHeight(rowPosition) | Integer | Pobiera wysokość danego wiersza w pikselach. |
getSelection() | Selection | Zwraca bieżącą Selection z arkusza kalkulacyjnego. |
getSheetId() | Integer | Zwraca identyfikator arkusza reprezentowanego przez ten obiekt. |
getSheetName() | String | Zwraca nazwę arkusza. |
getSheetValues(startRow, startColumn, numRows, numColumns) | Object[][] | Zwraca prostokątną siatkę wartości z tego zakresu, zaczynając od podanych współrzędnych. |
getSlicers() | Slicer[] | Zwraca tablicę fragmentatorów w arkuszu. |
getTabColorObject() | Color | Pobiera kolor karty arkusza lub null , jeśli nie ma ona koloru. |
getType() | SheetType | Zwraca typ arkusza. |
hasHiddenGridlines() | Boolean | Zwraca wartość true , jeśli linie siatki arkusza są ukryte. w przeciwnym razie zwraca false . |
hideColumn(column) | void | Ukrywa kolumnę lub kolumny w podanym zakresie. |
hideColumns(columnIndex) | void | Ukrywa 1 kolumnę w podanym indeksie. |
hideColumns(columnIndex, numColumns) | void | Ukrywa jedną lub więcej następujących po sobie kolumn, zaczynając od podanego indeksu. |
hideRow(row) | void | Ukrywa wiersze w podanym zakresie. |
hideRows(rowIndex) | void | Ukrywa wiersz w podanym indeksie. |
hideRows(rowIndex, numRows) | void | Ukrywa jeden lub więcej kolejnych wierszy zaczynających się od podanego indeksu. |
hideSheet() | Sheet | Ukrywa ten arkusz. |
insertChart(chart) | void | Dodaje nowy wykres do tego arkusza. |
insertColumnAfter(afterPosition) | Sheet | Wstawia kolumnę po określonej pozycji kolumny. |
insertColumnBefore(beforePosition) | Sheet | Wstawia kolumnę przed określoną pozycją kolumny. |
insertColumns(columnIndex) | void | Wstawia pustą kolumnę w arkuszu w określonym miejscu. |
insertColumns(columnIndex, numColumns) | void | Wstawia jedną lub więcej pustych kolumn w arkuszu od podanej lokalizacji. |
insertColumnsAfter(afterPosition, howMany) | Sheet | Wstawia podaną liczbę kolumn po określonej pozycji kolumny. |
insertColumnsBefore(beforePosition, howMany) | Sheet | Wstawia liczbę kolumn przed określoną pozycją kolumny. |
insertImage(blobSource, column, row) | OverGridImage | Wstawia obiekt BlobSource jako obraz w dokumencie w danym wierszu i kolumnie. |
insertImage(blobSource, column, row, offsetX, offsetY) | OverGridImage | Wstawia obiekt BlobSource jako obraz w dokumencie w danym wierszu i kolumnie, ze znakiem
w pikselach. |
insertImage(url, column, row) | OverGridImage | Wstawia obraz w dokumencie w danym wierszu i kolumnie. |
insertImage(url, column, row, offsetX, offsetY) | OverGridImage | Wstawia obraz w dokumencie w danym wierszu i danej kolumnie z przesunięciem w pikselach. |
insertRowAfter(afterPosition) | Sheet | Wstawia wiersz po określonej pozycji wiersza. |
insertRowBefore(beforePosition) | Sheet | Wstawia wiersz przed określoną pozycją wiersza. |
insertRows(rowIndex) | void | Wstawia pusty wiersz w arkuszu w określonej lokalizacji. |
insertRows(rowIndex, numRows) | void | Wstawia jeden lub więcej kolejnych pustych wierszy w arkuszu, zaczynając od określonej lokalizacji. |
insertRowsAfter(afterPosition, howMany) | Sheet | Wstawia liczbę wierszy po określonej pozycji wiersza. |
insertRowsBefore(beforePosition, howMany) | Sheet | Wstawia liczbę wierszy przed określoną pozycją wiersza. |
insertSlicer(range, anchorRowPos, anchorColPos) | Slicer | Dodaje nowy fragmentator do tego arkusza. |
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY) | Slicer | Dodaje nowy fragmentator do tego arkusza. |
isColumnHiddenByUser(columnPosition) | Boolean | Wskazuje, czy dana kolumna została ukryta przez użytkownika. |
isRightToLeft() | Boolean | Zwraca wartość true , jeśli ten układ arkusza jest układem od prawej do lewej. |
isRowHiddenByFilter(rowPosition) | Boolean | Wskazuje, czy dany wiersz jest ukryty przez filtr (nie przez widok filtra). |
isRowHiddenByUser(rowPosition) | Boolean | Wskazuje, czy dany wiersz został ukryty przez użytkownika. |
isSheetHidden() | Boolean | Zwraca wartość true , jeśli arkusz jest obecnie ukryty. |
moveColumns(columnSpec, destinationIndex) | void | Przenosi kolumny zaznaczone przez podany zakres do pozycji określonej przez destinationIndex . |
moveRows(rowSpec, destinationIndex) | void | Przenosi wiersze zaznaczone przez podany zakres do pozycji wskazywanej przez ikonę destinationIndex . |
newChart() | EmbeddedChartBuilder | Zwraca narzędzie do tworzenia nowego wykresu w tym arkuszu. |
protect() | Protection | Tworzy obiekt, który może chronić arkusz przed edytowaniem, poza użytkownikami, którzy uprawnienia. |
removeChart(chart) | void | Usuwa wykres z arkusza nadrzędnego. |
setActiveRange(range) | Range | Ustawia określony zakres jako element active range w aktywnym arkuszu, przy czym
lewą górną komórkę zakresu jako current cell . |
setActiveRangeList(rangeList) | RangeList | Ustawia określoną listę zakresów jako active ranges w
aktywny arkusz. |
setActiveSelection(range) | Range | Określa aktywny obszar zaznaczenia w tym arkuszu. |
setActiveSelection(a1Notation) | Range | Ustawia aktywny wybór zgodnie z notacją A1 lub R1C1. |
setColumnGroupControlPosition(position) | Sheet | Ustawia pozycję przełącznika kontroli grupy kolumn w arkuszu. |
setColumnWidth(columnPosition, width) | Sheet | Ustawia szerokość danej kolumny w pikselach. |
setColumnWidths(startColumn, numColumns, width) | Sheet | Ustawia szerokość podanych kolumn w pikselach. |
setConditionalFormatRules(rules) | void | Zastępuje wszystkie istniejące obecnie reguły formatowania warunkowego w arkuszu regułami danych wejściowych. |
setCurrentCell(cell) | Range | Ustawia określoną komórkę jako current cell . |
setFrozenColumns(columns) | void | Zatrzymuje określoną liczbę kolumn. |
setFrozenRows(rows) | void | Blokuje podaną liczbę wierszy. |
setHiddenGridlines(hideGridlines) | Sheet | Ukrywa lub ukrywa linie siatki w arkuszu. |
setName(name) | Sheet | Określa nazwę arkusza. |
setRightToLeft(rightToLeft) | Sheet | Ustawia układ arkusza od prawej do lewej lub cofa jego ustawienie. |
setRowGroupControlPosition(position) | Sheet | Ustawia pozycję przełącznika kontroli grupy wierszy w arkuszu. |
setRowHeight(rowPosition, height) | Sheet | Ustawia wysokość wiersza danego wiersza w pikselach. |
setRowHeights(startRow, numRows, height) | Sheet | Ustawia wysokość podanych wierszy w pikselach. |
setRowHeightsForced(startRow, numRows, height) | Sheet | Ustawia wysokość podanych wierszy w pikselach. |
setTabColor(color) | Sheet | Określa kolor karty arkusza. |
setTabColorObject(color) | Sheet | Określa kolor karty arkusza. |
showColumns(columnIndex) | void | Odkrywa kolumnę w podanym indeksie. |
showColumns(columnIndex, numColumns) | void | Odkrywanie jednej lub kilku kolejnych kolumn, zaczynając od podanego indeksu. |
showRows(rowIndex) | void | Odkrywa wiersz w danym indeksie. |
showRows(rowIndex, numRows) | void | Rozpoznaje jeden lub więcej kolejnych wierszy, zaczynając od podanego indeksu. |
showSheet() | Sheet | Sprawia, że arkusz jest widoczny. |
sort(columnPosition) | Sheet | Sortuje arkusz rosnąco według kolumny. |
sort(columnPosition, ascending) | Sheet | Sortuje arkusz według kolumny. |
unhideColumn(column) | void | Odkrywa kolumnę w podanym zakresie. |
unhideRow(row) | void | Odkrywa wiersz w podanym zakresie. |
updateChart(chart) | void | Aktualizuje wykres w tym arkuszu. |
Szczegółowa dokumentacja
activate()
Aktywuje ten arkusz. Nie zmienia samego arkusza, a jedynie sposób powiązania aktywnego przez wydawcę nadrzędnego arkusza kalkulacyjnego.
// 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 o określonym kluczu.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' to the developer metadata for the sheet. sheet.addDeveloperMetadata('NAME'); // Gets the updated metadata info and logs it to the console. console.log(sheet.getDeveloperMetadata()[0].getKey());
Parametry
Nazwa | Typ | Opis |
---|---|---|
key | String | Klucz nowych metadanych dewelopera. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Dodaje do arkusza metadane dewelopera o określonym kluczu i widoczności.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' and sets the developer metadata visibility to PROJECT // for the sheet. sheet.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getVisibility().toString());
Parametry
Nazwa | Typ | Opis |
---|---|---|
key | String | Klucz nowych metadanych dewelopera. |
visibility | DeveloperMetadataVisibility | Widoczność nowych metadanych dewelopera. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Dodaje do arkusza metadane dewelopera o określonym kluczu i wartości.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'COMPANY' with the value 'TECH' to the developer metadata for the sheet. sheet.addDeveloperMetadata('COMPANY', 'TECH'); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue());
Parametry
Nazwa | Typ | Opis |
---|---|---|
key | String | Klucz nowych metadanych dewelopera. |
value | String | Wartość nowych metadanych dewelopera. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Dodaje do arkusza metadane dewelopera o określonym kluczu, wartości i widoczności.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'COMPANY' with the value 'TECH' to the developer metadata and sets the // visibility to DOCUMENT for the sheet. sheet.addDeveloperMetadata( 'COMPANY', 'TECH', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
Parametry
Nazwa | Typ | Opis |
---|---|---|
key | String | Klucz nowych metadanych dewelopera. |
value | String | Wartość nowych metadanych dewelopera. |
visibility | DeveloperMetadataVisibility | Widoczność nowych metadanych dewelopera. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
appendRow(rowContents)
Dodaje wiersz na dole bieżącego regionu danych w arkuszu. Jeśli rozpoczyna się zawartość komórki
dla funkcji =
, jest ona interpretowana jako wzór.
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 tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
asDataSourceSheet()
Zwraca arkusz jako DataSourceSheet
, jeśli jest typu SheetType.DATASOURCE
. W przeciwnym razie zwraca 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.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnPosition)
Określa szerokość danej kolumny zgodnie z jej zawartością.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...'); // Sets the first column to a width which fits the text sheet.autoResizeColumn(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja danej kolumny, której rozmiar ma zostać zmieniony. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumns(startColumn, numColumns)
Ustawia szerokość wszystkich kolumn, zaczynając od danej pozycji, aby pasowała do zawartości.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first 15 columns to a width that fits their text. sheet.autoResizeColumns(1, 15);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startColumn | Integer | Automatyczny rozmiar kolumny początkowej. |
numColumns | Integer | Liczba kolumn do automatycznego zmiany rozmiaru. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeRows(startRow, numRows)
Ustawia wysokość wszystkich wierszy, zaczynając od danej pozycji, aby dopasować je do zawartości.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first 15 rows to a height that fits their text. sheet.autoResizeRows(1, 15);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startRow | Integer | Wiersz początkowy do automatycznego zmiany rozmiaru. |
numRows | Integer | Liczba wierszy, których rozmiar ma zostać automatycznie zmieniony. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Usuwa zawartość arkusza z informacjami 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
– wyczyszczony arkusz.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Czyści arkusz treści i/lub format zgodnie z podanymi 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 | Określa, czy usunąć zawartość. |
formatOnly | Boolean | Określa, czy usunąć format. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearConditionalFormatRules()
Usuwa z arkusza wszystkie reguły formatowania warunkowego. Odpowiednik wywołania funkcji setConditionalFormatRules(rules)
z pustą tablicą jako danymi wejściowymi.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.clearConditionalFormatRules();
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContents()
Czyści arkusz treści, zachowując informacje o formatowaniu.
// 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 tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormats()
Czyści arkusz formatowania, zachowując treść.
Formatowanie odnosi się do sposobu formatowania danych w sposób dozwolony przez opcje w sekcji „Format” menu (np. pogrubienie, kursywa, formatowanie warunkowe), a nie szerokość lub wysokość komórek.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.clearFormats();
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNotes()
Czyści arkusz 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 tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllColumnGroups()
Zwija wszystkie grupy kolumn w arkuszu.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are collapsed. sheet.collapseAllColumnGroups();
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseAllRowGroups()
Zwija wszystkie grupy wierszy w arkuszu.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are collapsed. sheet.collapseAllRowGroups();
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(spreadsheet)
Kopiuje arkusz do danego arkusza kalkulacyjnego, który może być tym samym arkuszem źródłowym. skopiowany arkusz ma nazwę „Kopia [nazwa oryginalna]”.
var source = SpreadsheetApp.getActiveSpreadsheet(); var sheet = source.getSheets()[0]; var destination = SpreadsheetApp.openById('ID_GOES HERE'); sheet.copyTo(destination);
Parametry
Nazwa | Typ | Opis |
---|---|---|
spreadsheet | Spreadsheet | Arkusz kalkulacyjny, do którego chcesz skopiować ten arkusz. Może to być ten sam arkusz kalkulacyjny, źródła. |
Powrót
Sheet
– nowy arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Zwraca DeveloperMetadataFinder
w przypadku znalezienia metadanych dewelopera w zakresie
ten arkusz. Metadane należą do zakresu konkretnego arkusza, jeśli są powiązane z
arkusza kalkulacyjnego lub powiązana z wierszem, kolumną bądź 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
– wyszukiwarka metadanych dewelopera służąca do wyszukiwania metadanych w zakresie tego arkusza.
createTextFinder(findText)
Tworzy wyszukiwarkę tekstu dla arkusza, która może znajdować i zastępować tekst w arkuszu.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Creates a text finder. var textFinder = sheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the sheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
Parametry
Nazwa | Typ | Opis |
---|---|---|
findText | String | Tekst do wyszukania. |
Powrót
TextFinder
– pole TextFinder
arkusza.
deleteColumn(columnPosition)
Usuwa kolumnę na podanej 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, zaczynająca się od 1 w pierwszej kolumnie. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
Usuwa określoną liczbę kolumn, zaczynając 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. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRow(rowPosition)
Usuwa wiersz na 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 tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
Usuwa liczbę wierszy, zaczynając od danej pozycji.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja pierwszego wiersza do usunięcia. |
howMany | Integer | Liczba wierszy do usunięcia. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandAllColumnGroups()
Rozwija wszystkie grupy kolumn w arkuszu. Ta metoda wymaga co najmniej 1 grupy kolumn.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are expanded. sheet.expandAllColumnGroups();
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandAllRowGroups()
Rozwija wszystkie grupy wierszy w arkuszu. Ta metoda wymaga co najmniej 1 grupy wierszy.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are expanded. sheet.expandAllRowGroups();
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandColumnGroupsUpToDepth(groupDepth)
Rozwija wszystkie grupy kolumn do danej głębokości i zwija wszystkie pozostałe.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups of depth 2 and lower are expanded, and groups with depth // 3 and higher are collapsed. sheet.expandColumnGroupsUpToDepth(2);
Parametry
Nazwa | Typ | Opis |
---|---|---|
groupDepth | Integer | Głębokość grupy, do której mają zostać rozwinięte grupy kolumn. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandRowGroupsUpToDepth(groupDepth)
Rozwija wszystkie grupy wierszy do danej głębokości i zwija wszystkie pozostałe.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups of depth 2 and lower are expanded, and groups with depth // 3 and higher are collapsed. sheet.expandRowGroupsUpToDepth(2);
Parametry
Nazwa | Typ | Opis |
---|---|---|
groupDepth | Integer | Głębokość grupy, do której mają zostać rozwinięte grupy wierszy. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveCell()
Zwraca aktywną komórkę w tym arkuszu.
Uwaga: lepiej użyć metody getCurrentCell()
, która zwraca bieżącą
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,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveRange()
Zwraca wybrany zakres w aktywnym arkuszu lub null
, jeśli nie ma aktywnego zakresu. Jeśli
wybrano wiele zakresów. Ta metoda zwraca tylko ostatnio wybrany zakres.
Termin „aktywny zakres” 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.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Zobacz też
getActiveRangeList()
Zwraca listę aktywnych zakresów w aktywnym arkuszu lub null
, jeśli nie ma żadnych aktywnych zakresów
zakresów.
Jeśli wybierzesz 1 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
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Zobacz też
getBandings()
Zwraca wszystkie pasma w tym arkuszu.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the banding info for the sheet. const bandings = sheet.getBandings(); // Gets info on the bandings' second row color and logs it to the console. for (const banding of bandings) { console.log(banding.getSecondRowColor()); }
Powrót
Banding[]
– wszystkie pasma w tym arkuszu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCharts()
Zwraca tablicę wykresów z tego arkusza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; // Do something with the chart }
Powrót
EmbeddedChart[]
– tablica wykresów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroup(columnIndex, groupDepth)
Zwraca grupę kolumn o danym indeksie i głębokości grupy.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at column 2 and has a depth of 1, or // null if the group doesn’t exist. var columnGroup = sheet.getColumnGroup(2, 1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnIndex | Integer | Indeks kolumny przełącznika kontroli grupy lub indeks w grupie. |
groupDepth | Integer | szczegółowość grupy, |
Powrót
Group
– grupa kolumn o indeksie kontrolnym i głębokości lub zgłasza wyjątek, jeśli grupa
nie istnieje.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupControlPosition()
Zwraca GroupControlTogglePosition
dla wszystkich grup kolumn w arkuszu.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the column grouping control toggle is shown after the // group. var columnGroupControlPosition = sheet.getColumnGroupControlPosition();
Powrót
GroupControlTogglePosition
– true
, jeśli przełącznik grupowania kolumn jest widoczny za grupą na tej
i false
w innym przypadku.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnGroupDepth(columnIndex)
Zwraca głębokość grupy dla kolumny o podanym indeksie.
Głębokość grupy wskazuje, ile grup pokrywa się z kolumną. Może się mieścić w zakresie od zero i osiem.
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 kolumny o danym indeksie.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumnWidth(columnPosition)
Pobiera szerokość danej kolumny w pikselach.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja kolumny do sprawdzenia. |
Powrót
Integer
– szerokość kolumny w pikselach
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getConditionalFormatRules()
Pobierz wszystkie reguły formatowania warunkowego z tego arkusza.
// 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.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCurrentCell()
Zwraca bieżącą komórkę w aktywnym arkuszu lub null
, jeśli nie ma bieżącej komórki.
bieżąca komórka to komórka podświetlona w interfejsie Arkuszy Google i podświetlona
obramowania. Bieżąca komórka nie może być więcej niż 1 komórka. Gdy użytkownik wybierze co najmniej jeden zakres komórek,
jedna z zaznaczonych komórek jest bieżącą komórką.
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,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRange()
Zwraca wartość Range
odpowiadającą wymiarom, w których znajdują się dane.
Jest to odpowiednik tworzenia zakresu ograniczonego przez wartości 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 w arkuszu kalkulacyjnym
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Pobiera wszystkie formuły źródła danych.
// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets // file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source formulas on Sheet1. // To get an array of data source formulas for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceFormulas = sheet.getDataSourceFormulas(); // Logs the first data source formula in the array. console.log(dataSourceFormulas[0].getFormula());
Powrót
DataSourceFormula[]
– lista formuł źródła danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
Pobiera wszystkie tabele przestawne źródła danych.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source pivot tables on Sheet1. // To get an array of data source pivot tables for the entire // spreadsheet, replace 'sheet' with 'ss'. const dataSourcePivotTables = sheet.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
Powrót
DataSourcePivotTable[]
– lista tabel przestawnych źródeł danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
Pobiera wszystkie tabele źródeł danych.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of data source tables on Sheet1. // To get an array of data source tables for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceTables = sheet.getDataSourceTables(); // Logs the last completed data execution time on the first data source table. console.log(dataSourceTables[0].getStatus().getLastExecutionTime());
Powrót
DataSourceTable[]
– lista tabel źródeł danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Pobierz wszystkie metadane dewelopera powiązane z tym arkuszem.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds developer metadata for testing. sheet.addDeveloperMetadata('CITY', 'PARIS'); // Gets all the developer metadata for the sheet. const developerMetaDataList = sheet.getDeveloperMetadata(); // Logs the developer metadata to the console. for (const developerMetaData of developerMetaDataList) { console.log(developerMetaData.getKey()); }
Powrót
DeveloperMetadata[]
– metadane dewelopera powiązane z tym arkuszem.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDrawings()
Zwraca tablicę rysunków w arkuszu.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all the drawings from the sheet. const allDrawings = sheet.getDrawings(); // Logs the number of drawings present on the sheet. console.log(allDrawings.length);
Powrót
Drawing[]
– lista rysunków w tym arkuszu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
Zwraca filtr w danym arkuszu lub null
, jeśli nie ma filtra.
// Gets the filter on the active sheet. let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter();
Powrót
Filter
– filtr.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormUrl()
Zwraca adres URL formularza, który wysyła odpowiedzi do tego arkusza, lub null
, jeśli ta funkcja
arkusz nie ma powiązanego formularza.
var sheet = SpreadsheetApp.getActiveSheet(); var url = sheet.getFormUrl();
Powrót
String
– adres URL formularza, w którym odpowiedzi są umieszczane w tym arkuszu, lub null
, jeśli ten
arkusz nie ma powiązanego formularza.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenColumns()
Zwraca liczbę zablokowanych kolumn.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
Powrót
Integer
– liczba zablokowanych kolumn
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenRows()
Zwraca liczbę zablokowanych wierszy.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
Powrót
Integer
– liczba zablokowanych wierszy.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getImages()
Zwraca wszystkie obrazy w arkuszu.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the over-the-grid images from Sheet1. // To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead. const images = sheet.getImages(); // For each image, logs the anchor cell in A1 notation. for (const image of images) { console.log(image.getAnchorCell().getA1Notation()); }
Powrót
OverGridImage[]
– tablica obrazów nad siatką.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIndex()
Pobiera pozycję arkusza w jego arkuszu kalkulacyjnym nadrzędnym. Zaczyna się o 1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); // Note that the JavaScript index is 0, but this logs 1 var sheet = ss.getSheets()[0]; // ... because spreadsheets are 1-indexed Logger.log(sheet.getIndex());
Powrót
Integer
– pozycja arkusza w jego nadrzędnym arkuszu kalkulacyjnym.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
Zwraca pozycję ostatniej kolumny, która zawiera treść.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Powrót
Integer
– ostatnia kolumna arkusza zawierającego treść
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
Zwraca pozycję ostatniego wiersza, który zawiera treść.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Powrót
Integer
– ostatni wiersz arkusza zawierającego treść;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxColumns()
Zwraca bieżącą liczbę kolumn w arkuszu niezależnie od treści.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); Logger.log(first.getMaxColumns());
Powrót
Integer
– maksymalna szerokość arkusza.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxRows()
Zwraca bieżącą liczbę wierszy w arkuszu niezależnie od 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.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getName()
Zwraca nazwę arkusza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getName());
Powrót
String
– nazwa arkusza.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNamedRanges()
Pobiera wszystkie nazwane zakresy z tego arkusza.
// The code below logs the name of the first named range. var namedRanges = SpreadsheetApp.getActiveSheet().getNamedRanges(); if (namedRanges.length > 1) { Logger.log(namedRanges[0].getName()); }
Powrót
NamedRange[]
– tablica wszystkich nazwanych zakresów w arkuszu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getParent()
Zwraca kolumnę Spreadsheet
, która zawiera 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.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPivotTables()
Zwraca wszystkie tabele przestawne z tego arkusza.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets 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.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getProtections(type)
Pobiera tablicę obiektów reprezentujących wszystkie zakresy chronione w arkuszu lub jeden element reprezentującą 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 zakresy chronione w arkuszu lub pojedynczy element
reprezentującą zabezpieczenie w samym arkuszu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column)
Zwraca zakres z lewą górną komórką przy podanych współrzędnych.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Passing only two arguments returns a "range" with a single cell. var range = sheet.getRange(1, 1); var values = range.getValues(); Logger.log(values[0][0]);
Parametry
Nazwa | Typ | Opis |
---|---|---|
row | Integer | indeks wiersza komórki, która ma zostać zwrócona; indeksowanie wierszy rozpoczyna się od liczby 1. |
column | Integer | indeks kolumny, która ma zostać zwrócona; indeksowanie kolumn rozpoczyna się od 1. |
Powrót
Range
– zakres zawierający tylko tę komórkę.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows)
Zwraca zakres z lewą górną komórką pod podanymi współrzędnymi i z podaną liczbą wierszy.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // When the "numRows" argument is used, only a single column of data is returned. var range = sheet.getRange(1, 1, 3); var values = range.getValues(); // Prints 3 values from the first column, starting from row 1. for (var row in values) { for (var col in values[row]) { Logger.log(values[row][col]); } }
Parametry
Nazwa | Typ | Opis |
---|---|---|
row | Integer | Indeks wiersza początkowego zakresu; indeksowanie wierszy rozpoczyna się od liczby 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 o określonej liczbie wierszy.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(row, column, numRows, numColumns)
Zwraca zakres z lewej górnej komórki przy podanych współrzędnych i podanej liczby wierszy i kolumny.
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 rozpoczyna się od liczby 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 określonemu obszarowi.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(a1Notation)
Zwraca zakres podany 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 do zwrócenia określony w notacji A1 lub notacji R1C1. |
Powrót
Range
– zakres w wyznaczonym miejscu
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRangeList(a1Notations)
Zwraca kolekcję RangeList
reprezentującą zakresy w tym samym określonym arkuszu
na niepustą listę notacji 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 notacją R1C1. |
Powrót
RangeList
– lista zakresów w wybranej lokalizacji
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroup(rowIndex, groupDepth)
Zwraca grupę wierszy o danym indeksie i głębokości grupy.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at row 2 and has a depth of 1, or // null if the group doesn’t exist. var rowGroup = sheet.getRowGroup(2, 1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowIndex | Integer | Indeks wiersza przełącznika kontroli grupy lub indeks w grupie. |
groupDepth | Integer | szczegółowość grupy, |
Powrót
Group
– grupa wierszy w indeksie kontrolnym i głębokości lub zgłasza wyjątek, jeśli grupa
nie istnieje.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupControlPosition()
Zwraca GroupControlTogglePosition
dla 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 za grupą w tym arkuszu widać przełącznik opcji grupowania wierszy
i false
w innym przypadku.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowGroupDepth(rowIndex)
Zwraca głębokość grupy wiersza o danym indeksie.
Głębokość grupy wskazuje, ile grup pokrywa się z wierszem. Może się mieścić w przedziale od 0 i osiem.
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 wiersza o danym indeksie.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowHeight(rowPosition)
Pobiera wysokość danego wiersza w pikselach.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja sprawdzanego wiersza. |
Powrót
Integer
– wysokość wiersza w pikselach
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
Zwraca bieżącą Selection
z arkusza kalkulacyjnego.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Powrót
Selection
– bieżący wybór
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetId()
Zwraca identyfikator arkusza reprezentowanego przez ten obiekt.
Jest to unikalny identyfikator arkusza. Identyfikator jest monotonicznie
rosnąca liczba całkowita przypisana podczas tworzenia arkusza, niezależna od pozycji arkusza. Ten
jest przydatny w połączeniu z metodami takimi jak Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
, które przyjmują parametr gridId
, a nie wystąpienie Sheet
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Powrót
Integer
– unikalny identyfikator arkusza;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetName()
Zwraca nazwę arkusza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Powrót
String
– nazwa arkusza,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(startRow, startColumn, numRows, numColumns)
Zwraca prostokątną siatkę wartości z tego zakresu, zaczynając od podanych współrzędnych. A -1 wartość podana jako pozycja wiersza lub kolumny jest równoważna z uzyskaniem ostatniego wiersza lub kolumny , który zawiera dane w arkuszu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startRow | Integer | Pozycja wiersza początkowego. |
startColumn | Integer | Pozycja kolumny początkowej. |
numRows | Integer | Liczba wierszy, dla których zostaną zwrócone wartości. |
numColumns | Integer | Liczba kolumn, dla których zostaną zwrócone wartości. |
Powrót
Object[][]
– dwuwymiarowa tablica wartości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSlicers()
Zwraca tablicę fragmentatorów w arkuszu.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all slicers in the spreadsheet. const slicers = sheet.getSlicers(); // Logs the slicer titles to the console. for (const slicer of slicers) { console.log(slicer.getTitle()); }
Powrót
Slicer[]
– lista fragmentatorów w tym arkuszu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTabColorObject()
Pobiera kolor karty arkusza lub null
, jeśli nie ma ona 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 nie ma ona koloru.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getType()
Zwraca typ arkusza.
Domyślny typ arkusza to SheetType.GRID
. Arkusz zawierający jedną umieszczoną
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.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hasHiddenGridlines()
Zwraca wartość true
, jeśli linie siatki arkusza są ukryte. w przeciwnym razie zwraca false
.
Domyślnie linie siatki są 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 innym przypadku false
.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
Ukrywa kolumnę lub kolumny w 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. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex)
Ukrywa 1 kolumnę w podanym indeksie. W przypadku tej metody użyj 1 indeksu.
Aby ukryć więcej niż 1 kolumnę za pomocą indeksu, użyj właściwości hideColumns(columnIndex, numColumns)
.
Aby ukryć więcej niż jedną kolumnę za pomocą zakresu, użyj funkcji 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. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumns(columnIndex, numColumns)
Ukrywa jedną lub więcej następujących po sobie kolumn, zaczynając od podanego indeksu. W przypadku tej metody użyj 1 indeksu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three columns sheet.hideColumns(1, 3);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnIndex | Integer | Indeks początkowy kolumn do ukrycia. |
numColumns | Integer | Liczba kolumn do ukrycia. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRow(row)
Ukrywa wiersze w 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. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex)
Ukrywa wiersz w podanym indeksie.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first row sheet.hideRows(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowIndex | Integer | Indeks wiersza do ukrycia. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRows(rowIndex, numRows)
Ukrywa jeden lub więcej kolejnych wierszy zaczynających się od podanego indeksu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Hides the first three rows sheet.hideRows(1, 3);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowIndex | Integer | Indeks początkowy wierszy do ukrycia. |
numRows | Integer | Liczba wierszy do ukrycia. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideSheet()
Ukrywa ten arkusz. Nie działa, jeśli arkusz jest już ukryty. Jeśli ta metoda jest wywoływana na tylko widoczny arkusz, więc zostanie zastosowany wyjątek.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.hideSheet();
Powrót
Sheet
– bieżący arkusz.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertChart(chart)
Dodaje nowy wykres do tego arkusza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This creates a simple bar chart from the first three rows // of the first two columns of the spreadsheet var chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange("A1:B4")) .setPosition(5, 5, 0, 0) .setOption("title", "Dynamic Chart") .build(); sheet.insertChart(chart);
Parametry
Nazwa | Typ | Opis |
---|---|---|
chart | EmbeddedChart | Wykres do wstawienia. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnAfter(afterPosition)
Wstawia kolumnę po określonej 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 ma zostać dodana nowa kolumna. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
Wstawia kolumnę przed określoną pozycją kolumny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
beforePosition | Integer | Kolumna, przed którą chcesz dodać nową kolumnę. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex)
Wstawia pustą kolumnę w arkuszu w określonym miejscu.
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ę. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumns(columnIndex, numColumns)
Wstawia jedną lub więcej pustych kolumn w arkuszu od podanej 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. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsAfter(afterPosition, howMany)
Wstawia podaną liczbę kolumn po określonej pozycji kolumny.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Inserts two columns after the first column on the first sheet of the spreadsheet. sheet.insertColumnsAfter(1,2);
Parametry
Nazwa | Typ | Opis |
---|---|---|
afterPosition | Integer | Kolumna, po której ma zostać dodana nowa kolumna. |
howMany | Integer | Liczba kolumn do wstawienia. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsBefore(beforePosition, howMany)
Wstawia liczbę kolumn przed określoną pozycją kolumny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
Parametry
Nazwa | Typ | Opis |
---|---|---|
beforePosition | Integer | Kolumna, przed którą chcesz dodać nową kolumnę. |
howMany | Integer | Liczba kolumn do wstawienia. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row)
Wstawia obiekt BlobSource
jako obraz w dokumencie w danym wierszu i kolumnie. Obraz
rozmiar jest pobierany z zawartości obiektu blob. Maksymalny obsługiwany rozmiar bloba to 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Obiekt blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę. |
column | Integer | Pozycja kolumny. |
row | Integer | Pozycja wiersza. |
Powrót
OverGridImage
– wstawiony obraz.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row, offsetX, offsetY)
Wstawia obiekt BlobSource
jako obraz w dokumencie w danym wierszu i kolumnie, ze znakiem
w pikselach. Rozmiar obrazu jest pobierany z zawartości obiektu blob. Maksymalny obsługiwany obiekt blob
Rozmiar pliku to 2MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
Parametry
Nazwa | Typ | Opis |
---|---|---|
blobSource | BlobSource | Obiekt blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę. |
column | Integer | Pozycja kolumny. |
row | Integer | Pozycja wiersza. |
offsetX | Integer | Odsunięcie w poziomie od rogu komórki w pikselach. |
offsetY | Integer | Odsunięcie w pionie od rogu komórki w pikselach. |
Powrót
OverGridImage
– wstawiony obraz.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row)
Wstawia obraz w dokumencie w danym wierszu i kolumnie.
Podany adres URL musi być publicznie dostępny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL obrazu. |
column | Integer | Pozycja kolumny siatki. |
row | Integer | Pozycja wiersza siatki. |
Powrót
OverGridImage
– wstawiony obraz.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row, offsetX, offsetY)
Wstawia obraz w dokumencie w danym wierszu i kolumnie z przesunięciem w pikselach.
Podany adres URL musi być publicznie dostępny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);
Parametry
Nazwa | Typ | Opis |
---|---|---|
url | String | Adres URL obrazu. |
column | Integer | Pozycja kolumny. |
row | Integer | Pozycja wiersza. |
offsetX | Integer | Odsunięcie w poziomie od rogu komórki w pikselach. |
offsetY | Integer | Odsunięcie w pionie od rogu komórki w pikselach. |
Powrót
OverGridImage
– wstawiony obraz.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowAfter(afterPosition)
Wstawia wiersz po określonej pozycji wiersza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
afterPosition | Integer | Wiersz, po którym chcesz dodać nowy wiersz. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowBefore(beforePosition)
Wstawia wiersz przed określoną pozycją wiersza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
beforePosition | Integer | Wiersz, przed którym chcesz dodać nowy wiersz. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex)
Wstawia pusty wiersz w arkuszu w określonej lokalizacji.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all rows down by one sheet.insertRows(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowIndex | Integer | Indeks wskazujący, gdzie wstawić wiersz. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRows(rowIndex, numRows)
Wstawia jeden lub więcej kolejnych pustych wierszy w arkuszu, zaczynając od określonej lokalizacji.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Shifts all rows down by three sheet.insertRows(1, 3);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowIndex | Integer | Indeks wskazujący, gdzie wstawić wiersz. |
numRows | Integer | Liczba wierszy do wstawienia. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsAfter(afterPosition, howMany)
Wstawia liczbę wierszy po określonej pozycji wiersza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
Parametry
Nazwa | Typ | Opis |
---|---|---|
afterPosition | Integer | Wiersz, po którym mają zostać dodane nowe wiersze. |
howMany | Integer | Liczba wierszy do wstawienia. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsBefore(beforePosition, howMany)
Wstawia liczbę wierszy przed określoną pozycją wiersza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
Parametry
Nazwa | Typ | Opis |
---|---|---|
beforePosition | Integer | Wiersz, w którym chcesz dodać nowe wiersze. |
howMany | Integer | Liczba wierszy do wstawienia. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos)
Dodaje nowy fragmentator do tego arkusza.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range of the sheet. const range = sheet.getRange('A1:D10'); // Inserts the slicer with a random range into the sheet. const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10); // Logs the insert slicer result to the console. console.log(insertSlicers);
Parametry
Nazwa | Typ | Opis |
---|---|---|
range | Range | Zakres, w którym tworzony jest fragmentator. |
anchorRowPos | Integer | Górna strona fragmentatora jest zakotwiczona w tym wierszu. |
anchorColPos | Integer | Górna strona fragmentatora jest zakotwiczona w tej kolumnie. |
Powrót
Slicer
– nowo wstawiony fragmentator.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)
Dodaje nowy fragmentator do tego arkusza.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range. const range = sheet.getRange('A1:D10'); // Inserts a slicer using the random range function. const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10, 0, 0); // Logs the insert slicer result to the console. console.log(insertSlicers);
Parametry
Nazwa | Typ | Opis |
---|---|---|
range | Range | Zakres, w którym tworzony jest fragmentator. |
anchorRowPos | Integer | Górna strona fragmentatora jest zakotwiczona w tym wierszu. |
anchorColPos | Integer | Górna strona fragmentatora jest zakotwiczona w tej kolumnie. |
offsetX | Integer | Odsunięcie w poziomie od rogu komórki w pikselach. |
offsetY | Integer | Odsunięcie w pionie od rogu komórki w pikselach. |
Powrót
Slicer
– nowo wstawiony fragmentator.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isColumnHiddenByUser(columnPosition)
Wskazuje, czy dana kolumna została 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, lub false
, jeśli jest ukryta.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRightToLeft()
Zwraca wartość true
, jeśli ten układ arkusza jest układem od prawej do lewej. Zwraca false
, jeśli arkusz
korzysta z 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 piszą od prawej do lewej, W innym przypadku false
.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByFilter(rowPosition)
Wskazuje, czy dany wiersz jest ukryty przez filtr (nie przez widok filtra).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja sprawdzanego wiersza. |
Powrót
Boolean
– true
, jeśli wiersz jest ukryty, lub false
, jeśli jest ukryty.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByUser(rowPosition)
Wskazuje, czy dany wiersz został 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 sprawdzanego wiersza. |
Powrót
Boolean
– true
, jeśli wiersz jest ukryty, lub false
, jeśli jest ukryty.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isSheetHidden()
Zwraca wartość true
, jeśli arkusz jest obecnie ukryty.
var sheet = SpreadsheetApp.getActiveSheet(); if (sheet.isSheetHidden()) { // do something... }
Powrót
Boolean
– true
, jeśli arkusz jest ukryty, lub false
, jeśli jest ukryty.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveColumns(columnSpec, destinationIndex)
Przenosi kolumny zaznaczone przez podany zakres do pozycji określonej przez destinationIndex
. Pole columnSpec
nie musi dokładnie odzwierciedlać całości
kolumnę lub grupę kolumn do przeniesienia – zostaną zaznaczone wszystkie kolumny, które obejmują dany zakres.
// The code below moves rows A-B to destination index 5. // This results in those columns becoming columns C-D. var sheet = SpreadsheetApp.getActiveSheet(); // Selects column A and column B to be moved. var columnSpec = sheet.getRange("A1:B1"); sheet.moveColumns(columnSpec, 5);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnSpec | Range | Zakres obejmujący kolumny, które należy przenieść. |
destinationIndex | Integer | Indeks, do którego powinny zostać przeniesione kolumny. Pamiętaj, że ten indeks jest na podstawie współrzędnych przed przeniesieniem kolumn. Istniejące dane są przesuwane w prawo do zrób miejsce na przeniesione kolumny, gdy kolumny źródłowe są usuwane z siatki. Z tego powodu dane mogą trafić do innego indeksu niż pierwotnie określony. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveRows(rowSpec, destinationIndex)
Przenosi wiersze zaznaczone przez podany zakres do pozycji wskazywanej przez ikonę destinationIndex
. Element rowSpec
nie musi dokładnie odpowiadać całemu wierszowi
lub grupę wierszy do przeniesienia – zostaną zaznaczone wszystkie wiersze objęte zakresem.
// 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 powinny zostać przeniesione. |
destinationIndex | Integer | Indeks, do którego powinny zostać przeniesione wiersze. Pamiętaj, że ten indeks jest na podstawie współrzędnych poprzedzających przeniesienie wierszy. Dotychczasowe dane są przesuwane w dół, aby miejsca na przeniesione wiersze, a wiersze źródłowe są usuwane z siatki. Dlatego dane mogą trafić do innego indeksu niż pierwotnie określony. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
newChart()
Zwraca narzędzie do tworzenia nowego wykresu w tym arkuszu.
Ten przykład pokazuje, jak utworzyć nowy wykres:
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B8"); var chartBuilder = sheet.newChart(); chartBuilder.addRange(range) .setChartType(Charts.ChartType.LINE) .setPosition(2, 2, 0, 0) .setOption('title', 'My Line Chart!'); sheet.insertChart(chartBuilder.build());
Powrót
EmbeddedChartBuilder
– narzędzie do tworzenia nowego wykresu.
protect()
Tworzy obiekt, który może chronić arkusz przed edytowaniem, poza użytkownikami, którzy
uprawnienia. Dopóki skrypt nie zmieni listy redaktorów arkusza (poprzez wywołanie
Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
lub ustawiam nowe
dla Protection.setDomainEdit(editable)
), uprawnienia są takie same
arkusza kalkulacyjnego, co w praktyce oznacza, że arkusz pozostaje niechroniony. Jeśli arkusz to
już chronione, ta metoda zwraca obiekt reprezentujący istniejące ustawienia zabezpieczeń.
Chroniony arkusz może zawierać niechronione regiony.
// Protect the active sheet, then remove all other users from the list of editors. var sheet = SpreadsheetApp.getActiveSheet(); var protection = sheet.protect().setDescription('Sample protected sheet'); // Ensure the current user is an editor before removing others. Otherwise, if the user's edit // permission comes from a group, the script throws an exception upon removing the group. var me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
Powrót
Protection
– obiekt reprezentujący ustawienia ochrony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeChart(chart)
Usuwa wykres z arkusza nadrzędnego.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This removes all the embedded charts from the spreadsheet var charts = sheet.getCharts(); for (var i in charts) { sheet.removeChart(charts[i]); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
chart | EmbeddedChart | Wykres do usunięcia. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRange(range)
Ustawia określony zakres jako element active range
w aktywnym arkuszu, przy czym
lewą górną komórkę zakresu jako current cell
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var range = sheet.getRange('A1:D4'); sheet.setActiveRange(range); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D4 var activeRange = selection.getActiveRange();
Parametry
Nazwa | Typ | Opis |
---|---|---|
range | Range | Zakres do ustawienia jako aktywny. |
Powrót
Range
– nowo aktywny zakres.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRangeList(rangeList)
Ustawia określoną listę zakresów jako active ranges
w
aktywny arkusz. Ostatni zakres na liście to active range
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); sheet.setActiveRangeList(rangeList); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Parametry
Nazwa | Typ | Opis |
---|---|---|
rangeList | RangeList | Lista zakresów do wyboru. |
Powrót
RangeList
– nowo wybrana lista zakresów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(range)
Określa aktywny obszar zaznaczenia w tym arkuszu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D4"); sheet.setActiveSelection(range);
Parametry
Nazwa | Typ | Opis |
---|---|---|
range | Range | Zakres do ustawienia jako aktywny. |
Powrót
Range
– nowo aktywny zakres.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(a1Notation)
Ustawia aktywny wybór zgodnie z notacją 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 ma zostać ustawiony jako aktywny, określony w notacji A1 lub R1C1. |
Powrót
Range
– nowo aktywny zakres.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnGroupControlPosition(position)
Ustawia pozycję przełącznika kontroli grupy kolumn w arkuszu.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setColumnGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
Parametry
Nazwa | Typ | Opis |
---|---|---|
position | GroupControlTogglePosition | Położenie przełącznika kontroli grupy kolumn. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidth(columnPosition, width)
Ustawia szerokość danej kolumny w pikselach.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first column to a width of 200 pixels sheet.setColumnWidth(1, 200);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Pozycja danej kolumny do ustawienia. |
width | Integer | Szerokość w pikselach, jaka ma być używana. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidths(startColumn, numColumns, width)
Ustawia szerokość podanych kolumn w pikselach.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three columns to a width of 200 pixels sheet.setColumnWidths(1, 3, 200);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startColumn | Integer | Pozycja kolumny początkowej do zmiany. |
numColumns | Integer | Liczba kolumn do zmiany. |
width | Integer | Szerokość w pikselach, jaka ma być używana. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setConditionalFormatRules(rules)
Zastępuje wszystkie istniejące obecnie reguły formatowania warunkowego w arkuszu regułami danych wejściowych. Reguły są sprawdzane w kolejności 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. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setCurrentCell(cell)
Ustawia określoną komórkę jako current cell
.
Jeśli określona komórka znajduje się w już wybranym zakresie, aktywny zakres z komórką bieżącą komórką.
Jeśli określonej komórki nie ma w żadnym wybranym zakresie, wszelkie istniejące zaznaczenie jest zostanie usunięta, a komórka stanie się bieżącą komórką i aktywnym zakresem.
Uwaga: określony Range
musi składać się z jednej komórki. W przeciwnym razie zwraca
wyjątek.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Parametry
Nazwa | Typ | Opis |
---|---|---|
cell | Range | Komórka, która ma zostać ustawiona jako bieżąca. |
Powrót
Range
– nowo ustawiona komórka,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenColumns(columns)
Zatrzymuje określoną liczbę kolumn. Jeśli wartość wynosi zero, żadne kolumny nie są zablokowane.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first column sheet.setFrozenColumns(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columns | Integer | Liczba kolumn do zablokowania. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenRows(rows)
Blokuje podaną liczbę wierszy. Jeśli wartość wynosi 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. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHiddenGridlines(hideGridlines)
Ukrywa lub ukrywa linie siatki w arkuszu.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can us eSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Hides the gridlines in the sheet. sheet.setHiddenGridlines(true);
Parametry
Nazwa | Typ | Opis |
---|---|---|
hideGridlines | Boolean | Jeśli true , ukryj linie siatki w tym arkuszu. w przeciwnym razie pokaż
linii siatki. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
Określa nazwę arkusza.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setName("not first anymore");
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Nowa nazwa arkusza. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRightToLeft(rightToLeft)
Ustawia układ arkusza od prawej do lewej lub cofa 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 true , układ arkusza jest ustawiony na od prawej do lewej, a komórka A1 ma wartość
w prawym górnym rogu. Jeśli false , układ arkusza jest ustawiony na domyślny.
od lewej do prawej, z komórką A1 w lewym górnym rogu. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowGroupControlPosition(position)
Ustawia pozycję przełącznika kontroli grupy wierszy w arkuszu.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);
Parametry
Nazwa | Typ | Opis |
---|---|---|
position | GroupControlTogglePosition | Położenie przełącznika kontroli grupy wierszy. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeight(rowPosition, height)
Ustawia wysokość wiersza danego wiersza w pikselach. Domyślnie wiersze są powiększane, aby dopasować się do zawartości komórki. Jeśli
chcesz wymusić wysokość wierszy do określonej wysokości, użyj funkcji setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first row to a height of 200 pixels sheet.setRowHeight(1, 200);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowPosition | Integer | Pozycja wiersza do zmiany. |
height | Integer | Wysokość w pikselach. |
Powrót
Sheet
– arkusz przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeights(startRow, numRows, height)
Ustawia wysokość podanych wierszy w pikselach. Domyślnie wiersze są powiększane, aby dopasować się do zawartości komórki. Jeśli
jeśli chcesz wymusić na wierszach określoną wysokość, użyj funkcji setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first three rows to a height of 20 pixels sheet.setRowHeights(1, 3, 20);
Parametry
Nazwa | Typ | Opis |
---|---|---|
startRow | Integer | Pozycja wiersza początkowego do zmiany. |
numRows | Integer | Liczba wierszy do zmiany. |
height | Integer | Wysokość w pikselach. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeightsForced(startRow, numRows, height)
Ustawia wysokość podanych wierszy w pikselach. Domyślnie wiersze są powiększane, aby dopasować się do zawartości komórki. Kiedy
użyjesz setRowHeightsForced
, wiersze zostaną wymuszone 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 wiersza początkowego do zmiany. |
numRows | Integer | Liczba wierszy do zmiany. |
height | Integer | Wysokość w pikselach. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColor(color)
Określa kolor karty arkusza.
// This example assumes there is a sheet named "first" var ss = SpreadsheetApp.getActiveSpreadsheet(); var first = ss.getSheetByName("first"); first.setTabColor("ff0000"); // Set the color to red. first.setTabColor(null); // Unset the color.
Parametry
Nazwa | Typ | Opis |
---|---|---|
color | String | kod koloru w notacji CSS (np. '#ffffff' lub 'white' );
null , aby zresetować kolor karty. |
Powrót
Sheet
– ten arkusz do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTabColorObject(color)
Określa 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 tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex)
Odkrywa kolumnę w 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. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showColumns(columnIndex, numColumns)
Odkrywanie jednej lub kilku kolejnych kolumn, zaczynając od podanego indeksu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three columns sheet.showColumns(1, 3);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnIndex | Integer | Indeks początkowy kolumn do odkrycia. |
numColumns | Integer | Liczba kolumn do odkrycia. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex)
Odkrywa wiersz w danym indeksie.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first row sheet.showRows(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowIndex | Integer | Indeks wiersza do odkrycia. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showRows(rowIndex, numRows)
Rozpoznaje jeden lub więcej kolejnych wierszy, zaczynając od podanego indeksu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Unhides the first three rows sheet.showRows(1, 3);
Parametry
Nazwa | Typ | Opis |
---|---|---|
rowIndex | Integer | Indeks początkowy wierszy do odkrycia. |
numRows | Integer | Liczba wierszy do odkrycia. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
showSheet()
Sprawia, że arkusz jest widoczny. Nie działa, jeśli arkusz jest już widoczny.
var sheet = SpreadsheetApp.getActiveSheet(); sheet.showSheet();
Powrót
Sheet
– bieżący arkusz.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition)
Sortuje arkusz rosnąco według kolumny.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, ascending sheet.sort(1);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Kolumna, według której ma być sortowana. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition, ascending)
Sortuje arkusz według kolumny. Przyjmuje parametr, aby określić rosnącą lub malejącą.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnPosition | Integer | Kolumna, według której ma być sortowana. |
ascending | Boolean | true – malejąco, false – malejąco. |
Powrót
Sheet
– arkusz, przydatny do tworzenia łańcuchów metod.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideColumn(column)
Odkrywa kolumnę w podanym zakresie.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideColumn(range);
Parametry
Nazwa | Typ | Opis |
---|---|---|
column | Range | Zakres do odkrycia (jeśli jest ukryty). |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideRow(row)
Odkrywa wiersz w podanym zakresie.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first row if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideRow(range);
Parametry
Nazwa | Typ | Opis |
---|---|---|
row | Range | Zakres do odkrycia (jeśli jest ukryty). |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateChart(chart)
Aktualizuje wykres w tym arkuszu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This code is going to loop through all the charts and change them to // column charts var charts = sheet.getCharts(); for (var i in charts) { var chart = charts[i]; var newChart = chart .modify() .setChartType(Charts.ChartType.COLUMN) .build(); sheet.updateChart(newChart); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
chart | EmbeddedChart | Wykres do zaktualizowania. |
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets