Class Sheet

Arkusze

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

MetodaZwracany typKrótki opis
activate()SheetAktywuje ten arkusz.
addDeveloperMetadata(key)SheetDodaje do arkusza metadane dewelopera o określonym kluczu.
addDeveloperMetadata(key, visibility)SheetDodaje do arkusza metadane dewelopera o określonym kluczu i widoczności.
addDeveloperMetadata(key, value)SheetDodaje do arkusza metadane dewelopera o określonym kluczu i wartości.
addDeveloperMetadata(key, value, visibility)SheetDodaje do arkusza metadane dewelopera o określonym kluczu, wartości i widoczności.
appendRow(rowContents)SheetDodaje wiersz na dole bieżącego regionu danych w arkuszu.
asDataSourceSheet()DataSourceSheetZwraca arkusz jako DataSourceSheet, jeśli jest typu SheetType.DATASOURCE. W przeciwnym razie zwraca null.
autoResizeColumn(columnPosition)SheetUstawia szerokość danej kolumny zgodnie z jej zawartością.
autoResizeColumns(startColumn, numColumns)SheetUstawia szerokość wszystkich kolumn, zaczynając od danej pozycji, aby pasowała do zawartości.
autoResizeRows(startRow, numRows)SheetUstawia wysokość wszystkich wierszy, zaczynając od danej pozycji, aby dopasować je do zawartości.
clear()SheetUsuwa zawartość arkusza z informacjami o formatowaniu.
clear(options)SheetCzyści arkusz treści i/lub format zgodnie z podanymi opcjami zaawansowanymi.
clearConditionalFormatRules()voidUsuwa z arkusza wszystkie reguły formatowania warunkowego.
clearContents()SheetCzyści arkusz treści, zachowując informacje o formatowaniu.
clearFormats()SheetCzyści arkusz formatowania, zachowując treść.
clearNotes()SheetCzyści arkusz wszystkich notatek.
collapseAllColumnGroups()SheetZwija wszystkie grupy kolumn w arkuszu.
collapseAllRowGroups()SheetZwija wszystkie grupy wierszy w arkuszu.
copyTo(spreadsheet)SheetKopiuje arkusz do danego arkusza kalkulacyjnego, który może być tym samym arkuszem źródłowym.
createDeveloperMetadataFinder()DeveloperMetadataFinderZwraca DeveloperMetadataFinder w przypadku znalezienia metadanych dewelopera w zakresie ten arkusz.
createTextFinder(findText)TextFinderTworzy wyszukiwarkę tekstu dla arkusza, która może znajdować i zastępować tekst w arkuszu.
deleteColumn(columnPosition)SheetUsuwa kolumnę na podanej pozycji.
deleteColumns(columnPosition, howMany)voidUsuwa określoną liczbę kolumn, zaczynając od danej pozycji.
deleteRow(rowPosition)SheetUsuwa wiersz na danej pozycji.
deleteRows(rowPosition, howMany)voidUsuwa liczbę wierszy, zaczynając od danej pozycji.
expandAllColumnGroups()SheetRozwija wszystkie grupy kolumn w arkuszu.
expandAllRowGroups()SheetRozwija wszystkie grupy wierszy w arkuszu.
expandColumnGroupsUpToDepth(groupDepth)SheetRozwija wszystkie grupy kolumn do danej głębokości i zwija wszystkie pozostałe.
expandRowGroupsUpToDepth(groupDepth)SheetRozwija wszystkie grupy wierszy do danej głębokości i zwija wszystkie pozostałe.
getActiveCell()RangeZwraca aktywną komórkę w tym arkuszu.
getActiveRange()RangeZwraca wybrany zakres w aktywnym arkuszu lub null, jeśli nie ma aktywnego zakresu.
getActiveRangeList()RangeListZwraca 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)GroupZwraca grupę kolumn o danym indeksie i głębokości grupy.
getColumnGroupControlPosition()GroupControlTogglePositionZwraca GroupControlTogglePosition dla wszystkich grup kolumn w arkuszu.
getColumnGroupDepth(columnIndex)IntegerZwraca głębokość grupy dla kolumny o podanym indeksie.
getColumnWidth(columnPosition)IntegerPobiera szerokość danej kolumny w pikselach.
getConditionalFormatRules()ConditionalFormatRule[]Pobierz wszystkie reguły formatowania warunkowego z tego arkusza.
getCurrentCell()RangeZwraca bieżącą komórkę w aktywnym arkuszu lub null, jeśli nie ma bieżącej komórki.
getDataRange()RangeZwraca 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()FilterZwraca filtr w danym arkuszu lub null, jeśli nie ma filtra.
getFormUrl()StringZwraca adres URL formularza, który wysyła odpowiedzi do tego arkusza, lub null, jeśli ta funkcja arkusz nie ma powiązanego formularza.
getFrozenColumns()IntegerZwraca liczbę zablokowanych kolumn.
getFrozenRows()IntegerZwraca liczbę zablokowanych wierszy.
getImages()OverGridImage[]Zwraca wszystkie obrazy w arkuszu.
getIndex()IntegerPobiera pozycję arkusza w jego arkuszu kalkulacyjnym nadrzędnym.
getLastColumn()IntegerZwraca pozycję ostatniej kolumny, która zawiera treść.
getLastRow()IntegerZwraca pozycję ostatniego wiersza, który zawiera treść.
getMaxColumns()IntegerZwraca bieżącą liczbę kolumn w arkuszu niezależnie od treści.
getMaxRows()IntegerZwraca bieżącą liczbę wierszy w arkuszu niezależnie od zawartości.
getName()StringZwraca nazwę arkusza.
getNamedRanges()NamedRange[]Pobiera wszystkie nazwane zakresy z tego arkusza.
getParent()SpreadsheetZwraca 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)RangeZwraca zakres z lewą górną komórką przy podanych współrzędnych.
getRange(row, column, numRows)RangeZwraca zakres z lewą górną komórką pod podanymi współrzędnymi i z podaną liczbą wierszy.
getRange(row, column, numRows, numColumns)RangeZwraca zakres z lewej górnej komórki przy podanych współrzędnych i podanej liczby wierszy i kolumny.
getRange(a1Notation)RangeZwraca zakres podany w notacji A1 lub R1C1.
getRangeList(a1Notations)RangeListZwraca kolekcję RangeList reprezentującą zakresy w tym samym określonym arkuszu na niepustą listę notacji A1 lub R1C1.
getRowGroup(rowIndex, groupDepth)GroupZwraca grupę wierszy o danym indeksie i głębokości grupy.
getRowGroupControlPosition()GroupControlTogglePositionZwraca GroupControlTogglePosition dla wszystkich grup wierszy w arkuszu.
getRowGroupDepth(rowIndex)IntegerZwraca głębokość grupy wiersza o danym indeksie.
getRowHeight(rowPosition)IntegerPobiera wysokość danego wiersza w pikselach.
getSelection()SelectionZwraca bieżącą Selection z arkusza kalkulacyjnego.
getSheetId()IntegerZwraca identyfikator arkusza reprezentowanego przez ten obiekt.
getSheetName()StringZwraca 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()ColorPobiera kolor karty arkusza lub null, jeśli nie ma ona koloru.
getType()SheetTypeZwraca typ arkusza.
hasHiddenGridlines()BooleanZwraca wartość true, jeśli linie siatki arkusza są ukryte. w przeciwnym razie zwraca false.
hideColumn(column)voidUkrywa kolumnę lub kolumny w podanym zakresie.
hideColumns(columnIndex)voidUkrywa 1 kolumnę w podanym indeksie.
hideColumns(columnIndex, numColumns)voidUkrywa jedną lub więcej następujących po sobie kolumn, zaczynając od podanego indeksu.
hideRow(row)voidUkrywa wiersze w podanym zakresie.
hideRows(rowIndex)voidUkrywa wiersz w podanym indeksie.
hideRows(rowIndex, numRows)voidUkrywa jeden lub więcej kolejnych wierszy zaczynających się od podanego indeksu.
hideSheet()SheetUkrywa ten arkusz.
insertChart(chart)voidDodaje nowy wykres do tego arkusza.
insertColumnAfter(afterPosition)SheetWstawia kolumnę po określonej pozycji kolumny.
insertColumnBefore(beforePosition)SheetWstawia kolumnę przed określoną pozycją kolumny.
insertColumns(columnIndex)voidWstawia pustą kolumnę w arkuszu w określonym miejscu.
insertColumns(columnIndex, numColumns)voidWstawia jedną lub więcej pustych kolumn w arkuszu od podanej lokalizacji.
insertColumnsAfter(afterPosition, howMany)SheetWstawia podaną liczbę kolumn po określonej pozycji kolumny.
insertColumnsBefore(beforePosition, howMany)SheetWstawia liczbę kolumn przed określoną pozycją kolumny.
insertImage(blobSource, column, row)OverGridImageWstawia obiekt BlobSource jako obraz w dokumencie w danym wierszu i kolumnie.
insertImage(blobSource, column, row, offsetX, offsetY)OverGridImageWstawia obiekt BlobSource jako obraz w dokumencie w danym wierszu i kolumnie, ze znakiem w pikselach.
insertImage(url, column, row)OverGridImageWstawia obraz w dokumencie w danym wierszu i kolumnie.
insertImage(url, column, row, offsetX, offsetY)OverGridImageWstawia obraz w dokumencie w danym wierszu i danej kolumnie z przesunięciem w pikselach.
insertRowAfter(afterPosition)SheetWstawia wiersz po określonej pozycji wiersza.
insertRowBefore(beforePosition)SheetWstawia wiersz przed określoną pozycją wiersza.
insertRows(rowIndex)voidWstawia pusty wiersz w arkuszu w określonej lokalizacji.
insertRows(rowIndex, numRows)voidWstawia jeden lub więcej kolejnych pustych wierszy w arkuszu, zaczynając od określonej lokalizacji.
insertRowsAfter(afterPosition, howMany)SheetWstawia liczbę wierszy po określonej pozycji wiersza.
insertRowsBefore(beforePosition, howMany)SheetWstawia liczbę wierszy przed określoną pozycją wiersza.
insertSlicer(range, anchorRowPos, anchorColPos)SlicerDodaje nowy fragmentator do tego arkusza.
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)SlicerDodaje nowy fragmentator do tego arkusza.
isColumnHiddenByUser(columnPosition)BooleanWskazuje, czy dana kolumna została ukryta przez użytkownika.
isRightToLeft()BooleanZwraca wartość true, jeśli ten układ arkusza jest układem od prawej do lewej.
isRowHiddenByFilter(rowPosition)BooleanWskazuje, czy dany wiersz jest ukryty przez filtr (nie przez widok filtra).
isRowHiddenByUser(rowPosition)BooleanWskazuje, czy dany wiersz został ukryty przez użytkownika.
isSheetHidden()BooleanZwraca wartość true, jeśli arkusz jest obecnie ukryty.
moveColumns(columnSpec, destinationIndex)voidPrzenosi kolumny zaznaczone przez podany zakres do pozycji określonej przez destinationIndex.
moveRows(rowSpec, destinationIndex)voidPrzenosi wiersze zaznaczone przez podany zakres do pozycji wskazywanej przez ikonę destinationIndex.
newChart()EmbeddedChartBuilderZwraca narzędzie do tworzenia nowego wykresu w tym arkuszu.
protect()ProtectionTworzy obiekt, który może chronić arkusz przed edytowaniem, poza użytkownikami, którzy uprawnienia.
removeChart(chart)voidUsuwa wykres z arkusza nadrzędnego.
setActiveRange(range)RangeUstawia określony zakres jako element active range w aktywnym arkuszu, przy czym lewą górną komórkę zakresu jako current cell.
setActiveRangeList(rangeList)RangeListUstawia określoną listę zakresów jako active ranges w aktywny arkusz.
setActiveSelection(range)RangeOkreśla aktywny obszar zaznaczenia w tym arkuszu.
setActiveSelection(a1Notation)RangeUstawia aktywny wybór zgodnie z notacją A1 lub R1C1.
setColumnGroupControlPosition(position)SheetUstawia pozycję przełącznika kontroli grupy kolumn w arkuszu.
setColumnWidth(columnPosition, width)SheetUstawia szerokość danej kolumny w pikselach.
setColumnWidths(startColumn, numColumns, width)SheetUstawia szerokość podanych kolumn w pikselach.
setConditionalFormatRules(rules)voidZastępuje wszystkie istniejące obecnie reguły formatowania warunkowego w arkuszu regułami danych wejściowych.
setCurrentCell(cell)RangeUstawia określoną komórkę jako current cell.
setFrozenColumns(columns)voidZatrzymuje określoną liczbę kolumn.
setFrozenRows(rows)voidBlokuje podaną liczbę wierszy.
setHiddenGridlines(hideGridlines)SheetUkrywa lub ukrywa linie siatki w arkuszu.
setName(name)SheetOkreśla nazwę arkusza.
setRightToLeft(rightToLeft)SheetUstawia układ arkusza od prawej do lewej lub cofa jego ustawienie.
setRowGroupControlPosition(position)SheetUstawia pozycję przełącznika kontroli grupy wierszy w arkuszu.
setRowHeight(rowPosition, height)SheetUstawia wysokość wiersza danego wiersza w pikselach.
setRowHeights(startRow, numRows, height)SheetUstawia wysokość podanych wierszy w pikselach.
setRowHeightsForced(startRow, numRows, height)SheetUstawia wysokość podanych wierszy w pikselach.
setTabColor(color)SheetOkreśla kolor karty arkusza.
setTabColorObject(color)SheetOkreśla kolor karty arkusza.
showColumns(columnIndex)voidOdkrywa kolumnę w podanym indeksie.
showColumns(columnIndex, numColumns)voidOdkrywanie jednej lub kilku kolejnych kolumn, zaczynając od podanego indeksu.
showRows(rowIndex)voidOdkrywa wiersz w danym indeksie.
showRows(rowIndex, numRows)voidRozpoznaje jeden lub więcej kolejnych wierszy, zaczynając od podanego indeksu.
showSheet()SheetSprawia, że arkusz jest widoczny.
sort(columnPosition)SheetSortuje arkusz rosnąco według kolumny.
sort(columnPosition, ascending)SheetSortuje arkusz według kolumny.
unhideColumn(column)voidOdkrywa kolumnę w podanym zakresie.
unhideRow(row)voidOdkrywa wiersz w podanym zakresie.
updateChart(chart)voidAktualizuje 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

NazwaTypOpis
keyStringKlucz 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

NazwaTypOpis
keyStringKlucz nowych metadanych dewelopera.
visibilityDeveloperMetadataVisibilityWidoczność 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

NazwaTypOpis
keyStringKlucz nowych metadanych dewelopera.
valueStringWartość 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

NazwaTypOpis
keyStringKlucz nowych metadanych dewelopera.
valueStringWartość nowych metadanych dewelopera.
visibilityDeveloperMetadataVisibilityWidoczność 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

NazwaTypOpis
rowContentsObject[]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

NazwaTypOpis
columnPositionIntegerPozycja 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

NazwaTypOpis
startColumnIntegerAutomatyczny rozmiar kolumny początkowej.
numColumnsIntegerLiczba 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

NazwaTypOpis
startRowIntegerWiersz początkowy do automatycznego zmiany rozmiaru.
numRowsIntegerLiczba 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

NazwaTypOpis
optionsObjectMapa JavaScript zawierająca opcje zaawansowane wymienione poniżej.

Parametry zaawansowane

NazwaTypOpis
contentsOnlyBooleanOkreśla, czy usunąć zawartość.
formatOnlyBooleanOkreś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

NazwaTypOpis
spreadsheetSpreadsheetArkusz 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

NazwaTypOpis
findTextStringTekst 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

NazwaTypOpis
columnPositionIntegerPozycja 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

NazwaTypOpis
columnPositionIntegerPozycja pierwszej kolumny do usunięcia.
howManyIntegerLiczba 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

NazwaTypOpis
rowPositionIntegerPozycja 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

NazwaTypOpis
rowPositionIntegerPozycja pierwszego wiersza do usunięcia.
howManyIntegerLiczba 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

NazwaTypOpis
groupDepthIntegerGłę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

NazwaTypOpis
groupDepthIntegerGłę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

NazwaTypOpis
columnIndexIntegerIndeks kolumny przełącznika kontroli grupy lub indeks w grupie.
groupDepthIntegerszczegół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

GroupControlTogglePositiontrue, 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

NazwaTypOpis
columnIndexIntegerIndeks 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

NazwaTypOpis
columnPositionIntegerPozycja 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

NazwaTypOpis
typeProtectionTypeTyp 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

NazwaTypOpis
rowIntegerindeks wiersza komórki, która ma zostać zwrócona; indeksowanie wierszy rozpoczyna się od liczby 1.
columnIntegerindeks 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

NazwaTypOpis
rowIntegerIndeks wiersza początkowego zakresu; indeksowanie wierszy rozpoczyna się od liczby 1.
columnIntegerIndeks kolumny zakresu; indeksowanie kolumn rozpoczyna się od 1.
numRowsIntegerLiczba 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

NazwaTypOpis
rowIntegerIndeks wiersza początkowego zakresu; indeksowanie wierszy rozpoczyna się od liczby 1.
columnIntegerIndeks kolumny początkowej zakresu; indeksowanie kolumn rozpoczyna się od 1.
numRowsIntegerLiczba wierszy do zwrócenia.
numColumnsIntegerLiczba 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

NazwaTypOpis
a1NotationStringZakres 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

NazwaTypOpis
a1NotationsString[]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

NazwaTypOpis
rowIndexIntegerIndeks wiersza przełącznika kontroli grupy lub indeks w grupie.
groupDepthIntegerszczegół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

GroupControlTogglePositiontrue, 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

NazwaTypOpis
rowIndexIntegerIndeks 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

NazwaTypOpis
rowPositionIntegerPozycja 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

NazwaTypOpis
startRowIntegerPozycja wiersza początkowego.
startColumnIntegerPozycja kolumny początkowej.
numRowsIntegerLiczba wierszy, dla których zostaną zwrócone wartości.
numColumnsIntegerLiczba 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

Booleantrue, 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

NazwaTypOpis
columnRangeZakres 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

NazwaTypOpis
columnIndexIntegerIndeks 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

NazwaTypOpis
columnIndexIntegerIndeks początkowy kolumn do ukrycia.
numColumnsIntegerLiczba 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

NazwaTypOpis
rowRangeZakres 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

NazwaTypOpis
rowIndexIntegerIndeks 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

NazwaTypOpis
rowIndexIntegerIndeks początkowy wierszy do ukrycia.
numRowsIntegerLiczba 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

NazwaTypOpis
chartEmbeddedChartWykres 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

NazwaTypOpis
afterPositionIntegerKolumna, 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

NazwaTypOpis
beforePositionIntegerKolumna, 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

NazwaTypOpis
columnIndexIntegerIndeks 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

NazwaTypOpis
columnIndexIntegerIndeks wskazujący, gdzie wstawić kolumnę.
numColumnsIntegerLiczba 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

NazwaTypOpis
afterPositionIntegerKolumna, po której ma zostać dodana nowa kolumna.
howManyIntegerLiczba 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

NazwaTypOpis
beforePositionIntegerKolumna, przed którą chcesz dodać nową kolumnę.
howManyIntegerLiczba 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

NazwaTypOpis
blobSourceBlobSourceObiekt blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę.
columnIntegerPozycja kolumny.
rowIntegerPozycja 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

NazwaTypOpis
blobSourceBlobSourceObiekt blob zawierający zawartość obrazu, typ MIME i (opcjonalnie) nazwę.
columnIntegerPozycja kolumny.
rowIntegerPozycja wiersza.
offsetXIntegerOdsunięcie w poziomie od rogu komórki w pikselach.
offsetYIntegerOdsunię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

NazwaTypOpis
urlStringAdres URL obrazu.
columnIntegerPozycja kolumny siatki.
rowIntegerPozycja 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

NazwaTypOpis
urlStringAdres URL obrazu.
columnIntegerPozycja kolumny.
rowIntegerPozycja wiersza.
offsetXIntegerOdsunięcie w poziomie od rogu komórki w pikselach.
offsetYIntegerOdsunię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

NazwaTypOpis
afterPositionIntegerWiersz, 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

NazwaTypOpis
beforePositionIntegerWiersz, 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

NazwaTypOpis
rowIndexIntegerIndeks 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

NazwaTypOpis
rowIndexIntegerIndeks wskazujący, gdzie wstawić wiersz.
numRowsIntegerLiczba 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

NazwaTypOpis
afterPositionIntegerWiersz, po którym mają zostać dodane nowe wiersze.
howManyIntegerLiczba 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

NazwaTypOpis
beforePositionIntegerWiersz, w którym chcesz dodać nowe wiersze.
howManyIntegerLiczba 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

NazwaTypOpis
rangeRangeZakres, w którym tworzony jest fragmentator.
anchorRowPosIntegerGórna strona fragmentatora jest zakotwiczona w tym wierszu.
anchorColPosIntegerGó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

NazwaTypOpis
rangeRangeZakres, w którym tworzony jest fragmentator.
anchorRowPosIntegerGórna strona fragmentatora jest zakotwiczona w tym wierszu.
anchorColPosIntegerGórna strona fragmentatora jest zakotwiczona w tej kolumnie.
offsetXIntegerOdsunięcie w poziomie od rogu komórki w pikselach.
offsetYIntegerOdsunię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

NazwaTypOpis
columnPositionIntegerPozycja kolumny do sprawdzenia.

Powrót

Booleantrue, 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

Booleantrue, 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

NazwaTypOpis
rowPositionIntegerPozycja sprawdzanego wiersza.

Powrót

Booleantrue, 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

NazwaTypOpis
rowPositionIntegerPozycja sprawdzanego wiersza.

Powrót

Booleantrue, 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

Booleantrue, 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

NazwaTypOpis
columnSpecRangeZakres obejmujący kolumny, które należy przenieść.
destinationIndexIntegerIndeks, 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

NazwaTypOpis
rowSpecRangeZakres obejmujący wiersze, które powinny zostać przeniesione.
destinationIndexIntegerIndeks, 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

NazwaTypOpis
chartEmbeddedChartWykres 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

NazwaTypOpis
rangeRangeZakres 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

NazwaTypOpis
rangeListRangeListLista 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

NazwaTypOpis
rangeRangeZakres 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

NazwaTypOpis
a1NotationStringZakres, 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

NazwaTypOpis
positionGroupControlTogglePositionPoł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

NazwaTypOpis
columnPositionIntegerPozycja danej kolumny do ustawienia.
widthIntegerSzerokość 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

NazwaTypOpis
startColumnIntegerPozycja kolumny początkowej do zmiany.
numColumnsIntegerLiczba kolumn do zmiany.
widthIntegerSzerokość 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

NazwaTypOpis
rulesConditionalFormatRule[]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

NazwaTypOpis
cellRangeKomó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

NazwaTypOpis
columnsIntegerLiczba 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

NazwaTypOpis
rowsIntegerLiczba 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

NazwaTypOpis
hideGridlinesBooleanJeś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

NazwaTypOpis
nameStringNowa 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

NazwaTypOpis
rightToLeftBooleanJeś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

NazwaTypOpis
positionGroupControlTogglePositionPoł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

NazwaTypOpis
rowPositionIntegerPozycja wiersza do zmiany.
heightIntegerWysokość 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

NazwaTypOpis
startRowIntegerPozycja wiersza początkowego do zmiany.
numRowsIntegerLiczba wierszy do zmiany.
heightIntegerWysokość 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

NazwaTypOpis
startRowIntegerPozycja wiersza początkowego do zmiany.
numRowsIntegerLiczba wierszy do zmiany.
heightIntegerWysokość 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

NazwaTypOpis
colorStringkod 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

NazwaTypOpis
colorColorKolor 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

NazwaTypOpis
columnIndexIntegerIndeks 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

NazwaTypOpis
columnIndexIntegerIndeks początkowy kolumn do odkrycia.
numColumnsIntegerLiczba 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

NazwaTypOpis
rowIndexIntegerIndeks 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

NazwaTypOpis
rowIndexIntegerIndeks początkowy wierszy do odkrycia.
numRowsIntegerLiczba 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

NazwaTypOpis
columnPositionIntegerKolumna, 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

NazwaTypOpis
columnPositionIntegerKolumna, według której ma być sortowana.
ascendingBooleantrue – 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

NazwaTypOpis
columnRangeZakres 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

NazwaTypOpis
rowRangeZakres 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

NazwaTypOpis
chartEmbeddedChartWykres 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

Wycofane metody