Halaman ini diterjemahkan oleh Cloud Translation API.

Class Range

Mengakses dan mengubah rentang spreadsheet. Rentang dapat berupa sel tunggal dalam sheet atau sekelompok sel di dekatnya dalam sheet.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`activate()`	`Range`	Menetapkan rentang yang ditentukan sebagai `active range`, dengan sel kiri atas dalam rentang sebagai `current cell`.
`activateAsCurrentCell()`	`Range`	Menetapkan sel yang ditentukan sebagai `current cell`.
`addDeveloperMetadata(key)`	`Range`	Menambahkan metadata developer dengan kunci yang ditentukan ke rentang.
`addDeveloperMetadata(key, visibility)`	`Range`	Menambahkan metadata developer dengan kunci dan visibilitas yang ditentukan ke rentang tersebut.
`addDeveloperMetadata(key, value)`	`Range`	Menambahkan metadata developer dengan kunci dan nilai yang ditentukan ke rentang.
`addDeveloperMetadata(key, value, visibility)`	`Range`	Menambahkan metadata developer dengan kunci, nilai, dan visibilitas yang ditentukan ke rentang tersebut.
`applyColumnBanding()`	`Banding`	Menerapkan tema banding kolom default ke rentang.
`applyColumnBanding(bandingTheme)`	`Banding`	Menerapkan tema banding kolom yang ditentukan ke rentang.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Menerapkan tema banding kolom yang ditentukan ke rentang dengan setelan header dan footer yang ditentukan.
`applyRowBanding()`	`Banding`	Menerapkan tema banding baris default ke rentang.
`applyRowBanding(bandingTheme)`	`Banding`	Menerapkan tema banding baris yang ditentukan ke rentang.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Menerapkan tema banding baris yang ditentukan ke rentang dengan setelan header dan footer yang ditentukan.
`autoFill(destination, series)`	`void`	Mengisi `destinationRange` dengan data berdasarkan data dalam rentang ini.
`autoFillToNeighbor(series)`	`void`	Menghitung rentang yang akan diisi dengan data baru berdasarkan sel yang berdekatan dan secara otomatis mengisi rentang tersebut dengan nilai baru berdasarkan data yang ada dalam rentang ini.
`breakApart()`	`Range`	Pisahkan sel multi-kolom dalam rentang menjadi sel tertentu lagi.
`canEdit()`	`Boolean`	Menentukan apakah pengguna memiliki izin untuk mengedit setiap sel dalam rentang.
`check()`	`Range`	Mengubah status kotak centang dalam rentang menjadi “dicentang”.
`clear()`	`Range`	Menghapus rentang konten dan format.
`clear(options)`	`Range`	Menghapus ragam konten, format, aturan validasi data, dan/atau komentar, sebagaimana ditentukan dengan opsi lanjutan yang diberikan.
`clearContent()`	`Range`	Menghapus konten rentang, tanpa mengubah formatnya.
`clearDataValidations()`	`Range`	Menghapus aturan validasi data untuk rentang tersebut.
`clearFormat()`	`Range`	Menghapus pemformatan untuk rentang ini.
`clearNote()`	`Range`	Menghapus catatan di satu atau beberapa sel tertentu.
`collapseGroups()`	`Range`	Ciutkan semua grup yang sepenuhnya berada dalam rentang tersebut.
`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Menyalin format rentang ke lokasi yang ditentukan.
`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Menyalin format rentang ke lokasi yang ditentukan.
`copyTo(destination)`	`void`	Menyalin data dari rentang sel ke rentang sel lain.
`copyTo(destination, copyPasteType, transposed)`	`void`	Menyalin data dari rentang sel ke rentang sel lain.
`copyTo(destination, options)`	`void`	Menyalin data dari rentang sel ke rentang sel lain.
`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Menyalin konten rentang ke lokasi yang ditentukan.
`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Menyalin konten rentang ke lokasi yang ditentukan.
`createDataSourcePivotTable(dataSource)`	`DataSourcePivotTable`	Membuat tabel pivot sumber data kosong dari sumber data, yang ditambatkan pada sel pertama dalam rentang ini.
`createDataSourceTable(dataSource)`	`DataSourceTable`	Membuat tabel sumber data kosong dari sumber data, yang ditambatkan pada sel pertama dalam rentang ini.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Menampilkan DeveloperMetadataFinderApi untuk menemukan metadata developer dalam cakupan rentang ini.
`createFilter()`	`Filter`	Membuat filter dan menerapkannya ke rentang yang ditentukan pada sheet.
`createPivotTable(sourceData)`	`PivotTable`	Membuat tabel pivot kosong dari `sourceData` yang ditentukan dan didasarkan pada sel pertama dalam rentang ini.
`createTextFinder(findText)`	`TextFinder`	Membuat pencari teks untuk rentang, yang dapat menemukan dan mengganti teks di rentang ini.
`deleteCells(shiftDimension)`	`void`	Menghapus rentang sel ini.
`expandGroups()`	`Range`	Memperluas grup yang diciutkan yang rentang atau tombol kontrolnya berpotongan dengan rentang ini.
`getA1Notation()`	`String`	Menampilkan deskripsi string rentang, dalam notasi A1.
`getBackground()`	`String`	Menampilkan warna latar belakang sel kiri atas dalam rentang (misalnya, `'#ffffff'`).
`getBackgroundObject()`	`Color`	Menampilkan warna latar belakang sel kiri atas dalam rentang.
`getBackgroundObjects()`	`Color[][]`	Menampilkan warna latar belakang sel dalam rentang.
`getBackgrounds()`	`String[][]`	Menampilkan warna latar belakang sel dalam rentang (misalnya, `'#ffffff'`).
`getBandings()`	`Banding[]`	Menampilkan semua banding yang diterapkan ke sel mana pun dalam rentang ini.
`getCell(row, column)`	`Range`	Menampilkan sel tertentu dalam rentang.
`getColumn()`	`Integer`	Menampilkan posisi kolom awal untuk rentang ini.
`getDataRegion()`	`Range`	Menampilkan salinan rentang yang diperluas dalam empat kardinal `Direction` untuk mencakup semua sel yang berdekatan dengan data di dalamnya.
`getDataRegion(dimension)`	`Range`	Menampilkan salinan rentang yang diperluas `Direction.UP` dan `Direction.DOWN` jika dimensi yang ditentukan adalah `Dimension.ROWS`, atau `Direction.NEXT` dan `Direction.PREVIOUS` jika dimensinya adalah `Dimension.COLUMNS`.
`getDataSourceFormula()`	`DataSourceFormula`	Menampilkan `DataSourceFormula` untuk sel pertama dalam rentang, atau `null` jika sel tidak berisi formula sumber data.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Menampilkan `DataSourceFormula` untuk sel dalam rentang.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Mendapatkan semua tabel pivot sumber data yang berpotongan dengan rentang.
`getDataSourceTables()`	`DataSourceTable[]`	Mendapatkan semua tabel sumber yang berpotongan dengan rentang.
`getDataSourceUrl()`	`String`	Menampilkan URL untuk data dalam rentang ini, yang dapat digunakan untuk membuat diagram dan kueri.
`getDataTable()`	`DataTable`	Tampilkan data di dalam objek ini sebagai DataTable.
`getDataTable(firstRowIsHeader)`	`DataTable`	Menampilkan data di dalam rentang ini sebagai DataTable.
`getDataValidation()`	`DataValidation`	Menampilkan aturan validasi data untuk sel kiri atas dalam rentang.
`getDataValidations()`	`DataValidation[][]`	Menampilkan aturan validasi data untuk semua sel dalam rentang.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Mendapatkan metadata developer yang terkait dengan rentang ini.
`getDisplayValue()`	`String`	Menampilkan nilai yang ditampilkan dari sel kiri atas dalam rentang.
`getDisplayValues()`	`String[][]`	Menampilkan petak nilai persegi panjang untuk rentang ini.
`getFilter()`	`Filter`	Menampilkan filter pada sheet yang memiliki rentang ini, atau `null` jika tidak ada filter pada sheet.
`getFontColorObject()`	`Color`	Menampilkan warna font sel di sudut kiri atas rentang.
`getFontColorObjects()`	`Color[][]`	Menampilkan warna font sel dalam rentang.
`getFontFamilies()`	`String[][]`	Menampilkan jenis font sel dalam rentang.
`getFontFamily()`	`String`	Menampilkan jenis font sel di sudut kiri atas rentang.
`getFontLine()`	`String`	Mendapatkan gaya garis sel di sudut kiri atas rentang (`'underline'`, `'line-through'`, atau `'none'`).
`getFontLines()`	`String[][]`	Mendapatkan gaya garis sel dalam rentang (`'underline'`, `'line-through'`, atau `'none'`).
`getFontSize()`	`Integer`	Menampilkan ukuran font dalam ukuran titik sel di pojok kiri atas rentang.
`getFontSizes()`	`Integer[][]`	Menampilkan ukuran font sel dalam rentang.
`getFontStyle()`	`String`	Menampilkan gaya font (`'italic'` atau `'normal'`) sel di pojok kiri atas rentang.
`getFontStyles()`	`String[][]`	Menampilkan gaya font sel dalam rentang.
`getFontWeight()`	`String`	Menampilkan ketebalan font (normal/tebal) sel di sudut kiri atas rentang.
`getFontWeights()`	`String[][]`	Menampilkan ketebalan font sel dalam rentang.
`getFormula()`	`String`	Menampilkan formula (notasi A1) untuk sel kiri atas rentang, atau string kosong jika sel kosong atau tidak berisi formula.
`getFormulaR1C1()`	`String`	Menampilkan formula (notasi R1C1) untuk sel tertentu, atau `null` jika tidak ada.
`getFormulas()`	`String[][]`	Menampilkan formula (notasi A1) untuk sel dalam rentang.
`getFormulasR1C1()`	`String[][]`	Menampilkan formula (notasi R1C1) untuk sel dalam rentang.
`getGridId()`	`Integer`	Menampilkan ID petak sheet induk rentang.
`getHeight()`	`Integer`	Menampilkan tinggi rentang.
`getHorizontalAlignment()`	`String`	Menampilkan perataan horizontal teks (kiri/tengah/kanan) sel di pojok kiri atas rentang.
`getHorizontalAlignments()`	`String[][]`	Menampilkan perataan horizontal sel dalam rentang.
`getLastColumn()`	`Integer`	Menampilkan posisi kolom akhir.
`getLastRow()`	`Integer`	Menampilkan posisi baris akhir.
`getMergedRanges()`	`Range[]`	Menampilkan array objek `Range` yang merepresentasikan sel gabungan yang sepenuhnya berada dalam rentang saat ini, atau berisi setidaknya satu sel dalam rentang saat ini.
`getNextDataCell(direction)`	`Range`	Mulai dari sel di kolom dan baris pertama rentang, menampilkan sel berikutnya di arah yang diberikan yang merupakan tepi dari rentang sel yang berdekatan dengan data di dalamnya atau sel di tepi spreadsheet dalam arah tersebut.
`getNote()`	`String`	Menampilkan catatan yang terkait dengan rentang tertentu.
`getNotes()`	`String[][]`	Menampilkan catatan yang terkait dengan sel dalam rentang.
`getNumColumns()`	`Integer`	Menampilkan jumlah kolom dalam rentang ini.
`getNumRows()`	`Integer`	Menampilkan jumlah baris dalam rentang ini.
`getNumberFormat()`	`String`	Mendapatkan pemformatan angka atau tanggal dari sel kiri atas rentang yang ditentukan.
`getNumberFormats()`	`String[][]`	Menampilkan format angka atau tanggal untuk sel dalam rentang.
`getRichTextValue()`	`RichTextValue`	Menampilkan nilai Rich Text untuk sel kiri atas rentang, atau `null` jika nilai sel bukan teks.
`getRichTextValues()`	`RichTextValue[][]`	Menampilkan nilai Rich Text untuk sel dalam rentang itu.
`getRow()`	`Integer`	Menampilkan posisi baris untuk rentang ini.
`getRowIndex()`	`Integer`	Menampilkan posisi baris untuk rentang ini.
`getSheet()`	`Sheet`	Menampilkan sheet yang mencakup rentang ini.
`getTextDirection()`	`TextDirection`	Menampilkan arah teks untuk sel kiri atas rentang.
`getTextDirections()`	`TextDirection[][]`	Menampilkan arah teks untuk sel dalam rentang.
`getTextRotation()`	`TextRotation`	Menampilkan pengaturan rotasi teks untuk sel kiri atas rentang.
`getTextRotations()`	`TextRotation[][]`	Menampilkan pengaturan rotasi teks untuk sel dalam rentang.
`getTextStyle()`	`TextStyle`	Menampilkan gaya teks untuk sel kiri atas rentang.
`getTextStyles()`	`TextStyle[][]`	Menampilkan gaya teks untuk sel dalam rentang tersebut.
`getValue()`	`Object`	Menampilkan nilai sel kiri atas dalam rentang.
`getValues()`	`Object[][]`	Menampilkan petak nilai persegi panjang untuk rentang ini.
`getVerticalAlignment()`	`String`	Menampilkan perataan vertikal (atas/tengah/bawah) sel di pojok kiri atas rentang.
`getVerticalAlignments()`	`String[][]`	Menampilkan perataan vertikal sel dalam rentang.
`getWidth()`	`Integer`	Menampilkan lebar rentang dalam kolom.
`getWrap()`	`Boolean`	Menampilkan apakah teks dalam sel digabungkan.
`getWrapStrategies()`	`WrapStrategy[][]`	Menampilkan strategi pengemasan teks untuk sel dalam rentang.
`getWrapStrategy()`	`WrapStrategy`	Menampilkan strategi pengemasan teks untuk sel kiri atas rentang.
`getWraps()`	`Boolean[][]`	Menampilkan apakah teks dalam sel digabungkan.
`insertCells(shiftDimension)`	`Range`	Menyisipkan sel kosong ke rentang ini.
`insertCheckboxes()`	`Range`	Menyisipkan kotak centang ke dalam setiap sel dalam rentang, yang dikonfigurasi dengan `true` untuk dicentang dan `false` untuk tidak dicentang.
`insertCheckboxes(checkedValue)`	`Range`	Menyisipkan kotak centang ke dalam setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk dicentang dan string kosong untuk tidak dicentang.
`insertCheckboxes(checkedValue, uncheckedValue)`	`Range`	Menyisipkan kotak centang ke dalam setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk status yang dicentang dan tidak dicentang.
`isBlank()`	`Boolean`	Menampilkan `true` jika rentang benar-benar kosong.
`isChecked()`	`Boolean`	Menampilkan apakah semua sel dalam rentang memiliki status kotak centang sebagai 'dicentang'.
`isEndColumnBounded()`	`Boolean`	Menentukan apakah akhir rentang terikat dengan kolom tertentu.
`isEndRowBounded()`	`Boolean`	Menentukan apakah akhir rentang terikat dengan baris tertentu.
`isPartOfMerge()`	`Boolean`	Menampilkan `true` jika sel dalam rentang saat ini tumpang-tindih dengan sel gabungan.
`isStartColumnBounded()`	`Boolean`	Menentukan apakah awal rentang terikat ke kolom tertentu.
`isStartRowBounded()`	`Boolean`	Menentukan apakah awal rentang terikat ke baris tertentu.
`merge()`	`Range`	Menggabungkan sel dalam rentang menjadi satu blok.
`mergeAcross()`	`Range`	Gabungkan sel dalam rentang di seluruh kolom rentang.
`mergeVertically()`	`Range`	Menggabungkan sel dalam rentang.
`moveTo(target)`	`void`	Potong dan tempel (format dan nilai) dari rentang ini ke rentang target.
`offset(rowOffset, columnOffset)`	`Range`	Menampilkan rentang baru yang diimbangi dari rentang ini dengan jumlah baris dan kolom tertentu (yang dapat negatif).
`offset(rowOffset, columnOffset, numRows)`	`Range`	Menampilkan rentang baru yang relatif terhadap rentang saat ini, yang titik kiri atasnya di-offset dari rentang saat ini oleh baris dan kolom tertentu, dan dengan tinggi yang diberikan dalam sel.
`offset(rowOffset, columnOffset, numRows, numColumns)`	`Range`	Menampilkan rentang baru yang relatif terhadap rentang saat ini, yang titik kiri atasnya di-offset dari rentang saat ini oleh baris dan kolom yang diberikan, dan dengan tinggi dan lebar yang ditentukan dalam sel.
`protect()`	`Protection`	Membuat objek yang dapat melindungi rentang agar tidak dapat diedit, kecuali oleh pengguna yang memiliki izin.
`randomize()`	`Range`	Mengacak urutan baris dalam rentang yang diberikan.
`removeCheckboxes()`	`Range`	Menghapus semua kotak centang dari rentang.
`removeDuplicates()`	`Range`	Menghapus baris dalam rentang ini yang berisi nilai yang merupakan duplikat nilai pada baris sebelumnya.
`removeDuplicates(columnsToCompare)`	`Range`	Menghapus baris dalam rentang ini yang berisi nilai di kolom tertentu yang merupakan duplikat nilai dari baris sebelumnya.
`setBackground(color)`	`Range`	Menetapkan warna latar belakang semua sel dalam rentang dalam notasi CSS (seperti `'#ffffff'` atau `'white'`).
`setBackgroundObject(color)`	`Range`	Menetapkan warna latar belakang semua sel dalam rentang.
`setBackgroundObjects(color)`	`Range`	Menetapkan petak persegi panjang warna latar belakang (harus cocok dengan dimensi rentang ini).
`setBackgroundRGB(red, green, blue)`	`Range`	Menetapkan latar belakang ke warna tertentu menggunakan nilai RGB (bilangan bulat antara 0 dan 255 inklusif).
`setBackgrounds(color)`	`Range`	Menetapkan petak persegi panjang warna latar belakang (harus cocok dengan dimensi rentang ini).
`setBorder(top, left, bottom, right, vertical, horizontal)`	`Range`	Menetapkan properti batas.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`Range`	Menetapkan properti batas dengan warna dan/atau gaya.
`setDataValidation(rule)`	`Range`	Menetapkan satu aturan validasi data untuk semua sel dalam rentang.
`setDataValidations(rules)`	`Range`	Menetapkan aturan validasi data untuk semua sel dalam rentang.
`setFontColor(color)`	`Range`	Menetapkan warna font dalam notasi CSS (seperti `'#ffffff'` atau `'white'`).
`setFontColorObject(color)`	`Range`	Menetapkan warna font dari rentang yang ditentukan.
`setFontColorObjects(colors)`	`Range`	Menetapkan petak persegi panjang warna font (harus cocok dengan dimensi rentang ini).
`setFontColors(colors)`	`Range`	Menetapkan petak persegi panjang warna font (harus cocok dengan dimensi rentang ini).
`setFontFamilies(fontFamilies)`	`Range`	Menetapkan petak persegi panjang jenis font (harus cocok dengan dimensi rentang ini).
`setFontFamily(fontFamily)`	`Range`	Menetapkan jenis font, seperti " infografis" atau "Hshader".
`setFontLine(fontLine)`	`Range`	Menetapkan gaya garis font dari rentang yang ditentukan (`'underline'`, `'line-through'`, atau `'none'`).
`setFontLines(fontLines)`	`Range`	Menetapkan petak persegi panjang gaya garis (harus sesuai dengan dimensi rentang ini).
`setFontSize(size)`	`Range`	Menetapkan ukuran font, dengan ukuran menjadi ukuran titik yang akan digunakan.
`setFontSizes(sizes)`	`Range`	Menetapkan petak persegi panjang ukuran font (harus cocok dengan dimensi rentang ini).
`setFontStyle(fontStyle)`	`Range`	Menetapkan gaya font untuk rentang yang ditentukan (`'italic'` atau `'normal'`).
`setFontStyles(fontStyles)`	`Range`	Menetapkan petak persegi panjang gaya font (harus cocok dengan dimensi rentang ini).
`setFontWeight(fontWeight)`	`Range`	Menetapkan ketebalan font untuk rentang tertentu (normal/tebal).
`setFontWeights(fontWeights)`	`Range`	Menetapkan petak persegi panjang ketebalan font (harus cocok dengan dimensi rentang ini).
`setFormula(formula)`	`Range`	Memperbarui formula untuk rentang ini.
`setFormulaR1C1(formula)`	`Range`	Memperbarui formula untuk rentang ini.
`setFormulas(formulas)`	`Range`	Menetapkan petak persegi panjang formula (harus cocok dengan dimensi rentang ini).
`setFormulasR1C1(formulas)`	`Range`	Menetapkan petak persegi panjang formula (harus cocok dengan dimensi rentang ini).
`setHorizontalAlignment(alignment)`	`Range`	Menetapkan perataan horizontal (kiri ke kanan) untuk rentang tertentu (kiri/tengah/kanan).
`setHorizontalAlignments(alignments)`	`Range`	Menetapkan petak persegi panjang perataan horizontal.
`setNote(note)`	`Range`	Menetapkan catatan ke nilai yang diberikan.
`setNotes(notes)`	`Range`	Menetapkan petak catatan persegi panjang (harus sesuai dengan dimensi rentang ini).
`setNumberFormat(numberFormat)`	`Range`	Menyetel format angka atau tanggal ke string pemformatan yang diberikan.
`setNumberFormats(numberFormats)`	`Range`	Menetapkan petak persegi panjang format angka atau tanggal (harus sesuai dengan dimensi rentang ini).
`setRichTextValue(value)`	`Range`	Menetapkan nilai Rich Text untuk sel dalam rentang.
`setRichTextValues(values)`	`Range`	Menetapkan petak persegi panjang nilai Rich Text.
`setShowHyperlink(showHyperlink)`	`Range`	Menetapkan apakah rentang harus menampilkan hyperlink atau tidak.
`setTextDirection(direction)`	`Range`	Menetapkan arah teks untuk sel dalam rentang.
`setTextDirections(directions)`	`Range`	Menetapkan petak persegi panjang rute teks.
`setTextRotation(degrees)`	`Range`	Menetapkan pengaturan rotasi teks untuk sel dalam rentang.
`setTextRotation(rotation)`	`Range`	Menetapkan pengaturan rotasi teks untuk sel dalam rentang.
`setTextRotations(rotations)`	`Range`	Menetapkan petak rotasi teks persegi panjang.
`setTextStyle(style)`	`Range`	Menetapkan gaya teks untuk sel dalam rentang.
`setTextStyles(styles)`	`Range`	Menetapkan petak persegi panjang gaya teks.
`setValue(value)`	`Range`	Menetapkan nilai rentang.
`setValues(values)`	`Range`	Menetapkan petak nilai persegi panjang (harus cocok dengan dimensi rentang ini).
`setVerticalAlignment(alignment)`	`Range`	Menetapkan perataan vertikal (atas ke bawah) untuk rentang yang ditentukan (atas/tengah/bawah).
`setVerticalAlignments(alignments)`	`Range`	Menetapkan petak persegi panjang perataan vertikal (harus cocok dengan dimensi rentang ini).
`setVerticalText(isVertical)`	`Range`	Menetapkan apakah teks akan ditumpuk untuk sel dalam rentang atau tidak.
`setWrap(isWrapEnabled)`	`Range`	Menetapkan penggabungan sel untuk rentang yang ditentukan.
`setWrapStrategies(strategies)`	`Range`	Menetapkan petak strategi wrap persegi panjang.
`setWrapStrategy(strategy)`	`Range`	Menetapkan strategi pengemasan teks untuk sel dalam rentang.
`setWraps(isWrapEnabled)`	`Range`	Menetapkan petak persegi panjang kebijakan penggabungan kata (harus cocok dengan dimensi rentang ini).
`shiftColumnGroupDepth(delta)`	`Range`	Mengubah kedalaman pengelompokan kolom dari rentang berdasarkan jumlah yang ditentukan.
`shiftRowGroupDepth(delta)`	`Range`	Mengubah kedalaman pengelompokan baris dari rentang berdasarkan jumlah yang ditentukan.
`sort(sortSpecObj)`	`Range`	Mengurutkan sel dalam rentang yang diberikan, berdasarkan kolom dan urutan yang ditentukan.
`splitTextToColumns()`	`void`	Memisahkan kolom teks menjadi beberapa kolom berdasarkan pembatas yang terdeteksi otomatis.
`splitTextToColumns(delimiter)`	`void`	Memisahkan kolom teks menjadi beberapa kolom menggunakan string yang ditentukan sebagai pembatas kustom.
`splitTextToColumns(delimiter)`	`void`	Memisahkan kolom teks menjadi beberapa kolom berdasarkan pembatas yang ditentukan.
`trimWhitespace()`	`Range`	Memangkas spasi kosong (seperti spasi, tab, atau baris baru) di setiap sel dalam rentang ini.
`uncheck()`	`Range`	Mengubah status kotak centang dalam rentang menjadi “tidak dicentang”.

Metode yang tidak digunakan lagi

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`getFontColor()`	`String`	Menampilkan warna font sel di sudut kiri atas rentang, dalam notasi CSS (seperti `'#ffffff'` atau `'white'`).
`getFontColors()`	`String[][]`	Menampilkan warna font sel dalam rentang dalam notasi CSS (seperti `'#ffffff'` atau `'white'`).

Dokumentasi mendetail

`activate()`

Menetapkan rentang yang ditentukan sebagai active range, dengan sel kiri atas dalam rentang sebagai current cell.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:D10');
range.activate();

var selection = sheet.getSelection();
// Current cell: A1
var currentCell = selection.getCurrentCell();
// Active Range: A1:D10
var activeRange = selection.getActiveRange();

Return

Range — Rentang ini, untuk perantaian.

`activateAsCurrentCell()`

Menetapkan sel yang ditentukan sebagai current cell.

Jika sel yang ditentukan ada dalam rentang yang ada, rentang tersebut akan menjadi rentang aktif dengan sel tersebut sebagai sel saat ini.

Jika sel yang ditentukan tidak ada dalam rentang yang ada, pilihan yang ada akan dihapus dan sel akan menjadi sel saat ini dan rentang aktif.

Catatan: Range yang ditentukan harus terdiri dari satu sel; jika tidak, pengecualian akan ditampilkan.

// Gets the first sheet of the spreadsheet.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];

// Gets the cell B5 and sets it as the active cell.
var range = sheet.getRange('B5');
var currentCell = range.activateAsCurrentCell();

// Logs the activated cell.
console.log(currentCell.getA1Notation());

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`addDeveloperMetadata(key)`

Menambahkan metadata developer dengan kunci yang ditentukan ke rentang.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' to the developer metadata for row 2.
range.addDeveloperMetadata('NAME');

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

Parameter

Nama	Type	Deskripsi
`key`	`String`	Kunci untuk metadata developer baru.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`addDeveloperMetadata(key, visibility)`

Menambahkan metadata developer dengan kunci dan visibilitas yang ditentukan ke rentang tersebut.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT'
// for row 2 on Sheet1.
range.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

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

Parameter

Nama	Type	Deskripsi
`key`	`String`	Kunci untuk metadata developer baru.
`visibility`	`DeveloperMetadataVisibility`	Visibilitas metadata developer baru.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`addDeveloperMetadata(key, value)`

Menambahkan metadata developer dengan kunci dan nilai yang ditentukan ke rentang.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

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

Parameter

Nama	Type	Deskripsi
`key`	`String`	Kunci untuk metadata developer baru.
`value`	`String`	Nilai untuk metadata developer baru.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`addDeveloperMetadata(key, value, visibility)`

Menambahkan metadata developer dengan kunci, nilai, dan visibilitas yang ditentukan ke rentang tersebut.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to PROJECT for row 2 on the sheet.
range.addDeveloperMetadata(
  'NAME',
  'GOOGLE',
  SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

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

Parameter

Nama	Type	Deskripsi
`key`	`String`	Kunci untuk metadata developer baru.
`value`	`String`	Nilai untuk metadata developer baru.
`visibility`	`DeveloperMetadataVisibility`	Visibilitas metadata developer baru.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`applyColumnBanding()`

Menerapkan tema banding kolom default ke rentang. Secara default, garis banding memiliki header dan tidak ada warna footer.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies column banding to row 2.
const colBanding = range.applyColumnBanding();

// Gets the first banding on the sheet and logs the color of the header column.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject().asRgbColor().asHexString());

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

Return

Banding — Garis baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`applyColumnBanding(bandingTheme)`

Menerapkan tema banding kolom yang ditentukan ke rentang. Secara default, garis banding memiliki header dan tidak ada warna footer.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies the INDIGO color banding theme to the columns in row 2.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

Parameter

Nama	Type	Deskripsi
`bandingTheme`	`BandingTheme`	Tema warna untuk diterapkan ke kolom dalam rentang.

Return

Banding — Garis baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

Menerapkan tema banding kolom yang ditentukan ke rentang dengan setelan header dan footer yang ditentukan.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 12-22 on the sheet.
const range = sheet.getRange('12:22');

// Applies the BLUE color banding theme to rows 12-22.
// Sets the header visibility to false and the footer visibility to true.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.BLUE, false, true);

// Gets the banding color and logs it to the console.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

// Gets the header color object and logs it to the console. Returns null because the header
// visibility is set to false.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject());

// Gets the footer color and logs it to the console.
console.log(sheet.getBandings()[0].getFooterColumnColorObject().asRgbColor().asHexString());

Parameter

Nama	Type	Deskripsi
`bandingTheme`	`BandingTheme`	Tema warna untuk diterapkan ke kolom dalam rentang.
`showHeader`	`Boolean`	Jika `true`, warna header tema banding diterapkan ke kolom pertama.
`showFooter`	`Boolean`	Jika `true`, warna footer tema banding diterapkan ke kolom terakhir.

Return

Banding — Garis baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`applyRowBanding()`

Menerapkan tema banding baris default ke rentang. Secara default, garis banding memiliki header dan tidak ada warna footer.

Return

Banding — Garis baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`applyRowBanding(bandingTheme)`

Menerapkan tema banding baris yang ditentukan ke rentang. Secara default, garis banding memiliki header dan tidak ada warna footer.

Parameter

Nama	Type	Deskripsi
`bandingTheme`	`BandingTheme`	Tema warna untuk diterapkan ke baris dalam rentang.

Return

Banding — Garis baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`applyRowBanding(bandingTheme, showHeader, showFooter)`

Menerapkan tema banding baris yang ditentukan ke rentang dengan setelan header dan footer yang ditentukan.

Parameter

Nama	Type	Deskripsi
`bandingTheme`	`BandingTheme`	Tema warna untuk diterapkan ke baris dalam rentang.
`showHeader`	`Boolean`	Jika `true`, warna header tema banding diterapkan ke baris pertama.
`showFooter`	`Boolean`	Jika `true`, warna footer tema banding diterapkan ke baris terakhir.

Return

Banding — Garis baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`autoFill(destination, series)`

Mengisi destinationRange dengan data berdasarkan data dalam rentang ini. Nilai baru juga ditentukan oleh jenis series yang ditentukan. Rentang tujuan harus berisi rentang ini dan memperluasnya hanya ke satu arah. Misalnya, kode berikut mengisi A1:A20 dengan serangkaian peningkatan nomor berdasarkan nilai saat ini di A1:A4:

var sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
var sourceRange = sheet.getRange("A1:A4");
// The range to fill with values.
var destination = sheet.getRange("A1:A20");

// Inserts new values in A5:A20, continuing the pattern expressed in A1:A4
sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

Parameter

Nama	Type	Deskripsi
`destination`	`Range`	Rentang yang akan diisi otomatis dengan nilai. Rentang tujuan harus berisi rentang ini dan memperluasnya hanya ke satu arah (ke atas, ke bawah, ke kiri, atau ke kanan).
`series`	`AutoFillSeries`	Jenis seri autoFill yang harus digunakan untuk menghitung nilai baru. Efek dari deret ini berbeda-beda berdasarkan jenis dan jumlah data sumber.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`autoFillToNeighbor(series)`

Menghitung rentang yang akan diisi dengan data baru berdasarkan sel yang berdekatan dan secara otomatis mengisi rentang tersebut dengan nilai baru berdasarkan data yang ada dalam rentang ini. Nilai baru ini juga ditentukan oleh jenis series yang ditentukan.

Rentang tujuan yang dihitung mempertimbangkan data di sekitarnya untuk menentukan tempat nilai baru harus dimasukkan: jika ada data di sebelah kiri atau kanan langsung kolom yang terisi otomatis, nilai baru hanya akan diperluas sejauh data yang berdekatan ini.

Misalnya, jika A1:A20 diisi dengan serangkaian angka yang meningkat dan metode ini dipanggil pada rentang B1:B4 yang berisi serangkaian tanggal, nilai baru hanya disisipkan ke dalam B5:B20. Dengan cara ini, nilai baru tersebut akan "menempel" pada sel yang berisi nilai di kolom A.

var sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
var sourceRange = sheet.getRange("B1:B4");

// Results in B5:B20 having values [1/5/2017, ... 1/20/2017]
sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

Parameter

Nama	Type	Deskripsi
`series`	`AutoFillSeries`	Jenis seri autoFill yang harus digunakan untuk menghitung nilai baru. Efek dari deret ini berbeda-beda berdasarkan jenis dan jumlah data sumber.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`breakApart()`

Pisahkan sel multi-kolom dalam rentang menjadi sel tertentu lagi.

Memanggil fungsi ini pada rentang sama dengan memilih rentang dan mengklik Format -> Gabungkan -> Pisahkan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`canEdit()`

Menentukan apakah pengguna memiliki izin untuk mengedit setiap sel dalam rentang. Pemilik spreadsheet selalu dapat mengedit rentang dan sheet yang dilindungi.

Return

Boolean — true jika pengguna memiliki izin untuk mengedit setiap sel dalam rentang; false jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`check()`

Mengubah status kotak centang dalam rentang menjadi “dicentang”. Mengabaikan sel dalam rentang yang saat ini tidak berisi nilai yang dicentang atau tidak dicentang yang dikonfigurasi.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'checked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`clear()`

Menghapus rentang konten dan format.

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

var range = sheet.getRange("A1:D10");
range.clear();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`clear(options)`

Menghapus ragam konten, format, aturan validasi data, dan/atau komentar, sebagaimana ditentukan dengan opsi lanjutan yang diberikan. Secara default, semua data akan dihapus.

// The code below clears range C2:G8 in the active sheet, but preserves the format,
// data validation rules, and comments.
SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});

Parameter

Nama	Type	Deskripsi
`options`	`Object`	Objek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini.

Parameter lanjutan

Nama	Type	Deskripsi
`commentsOnly`	`Boolean`	Apakah hanya menghapus komentar.
`contentsOnly`	`Boolean`	Apakah hanya menghapus konten.
`formatOnly`	`Boolean`	Apakah hanya menghapus format; perhatikan bahwa menghapus format juga akan menghapus aturan validasi data.
`validationsOnly`	`Boolean`	Apakah hanya menghapus aturan validasi data.
`skipFilteredRows`	`Boolean`	Apakah ingin menghindari pembersihan baris yang difilter.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`clearContent()`

Menghapus konten rentang, tanpa mengubah formatnya.

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

var range = sheet.getRange("A1:D10");
range.clearContent();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`clearDataValidations()`

Menghapus aturan validasi data untuk rentang tersebut.

// Clear the data validation rules for cells A1:B5.
var range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`clearFormat()`

Menghapus pemformatan untuk rentang ini.

Tindakan ini akan menghapus pemformatan teks untuk satu atau beberapa sel dalam rentang, tetapi tidak mereset aturan pemformatan angka apa pun.

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

var range = sheet.getRange("A1:D10");
range.clearFormat();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`clearNote()`

Menghapus catatan di satu atau beberapa sel tertentu.

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

var range = sheet.getRange("A1:D10");
range.clearNote();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`collapseGroups()`

Ciutkan semua grup yang sepenuhnya berada dalam rentang tersebut. Jika tidak ada grup yang sepenuhnya berada dalam rentang, grup terdalam yang berada sebagian dalam rentang akan diciutkan.

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

// All row and column groups within the range are collapsed.
range.collapseGroups();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`

Menyalin format rentang ke lokasi yang ditentukan. Jika tujuan lebih besar atau lebih kecil dari rentang sumber, sumber akan diulang atau dipotong. Perhatikan bahwa metode ini hanya menyalin format.

Untuk deskripsi mendetail tentang parameter gridId, lihat getGridId().

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

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId
// of a sheet by calling sheet.getSheetId() or range.getGridId().
range.copyFormatToRange(1555299895, 4, 6, 4, 6);

Parameter

Nama	Type	Deskripsi
`gridId`	`Integer`	ID unik sheet dalam spreadsheet, terlepas dari posisinya.
`column`	`Integer`	Kolom pertama dari rentang target.
`columnEnd`	`Integer`	Kolom akhir dari rentang target.
`row`	`Integer`	Baris awal rentang target.
`rowEnd`	`Integer`	Baris akhir rentang target.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

Lihat juga

getGridId()

`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`

Menyalin format rentang ke lokasi yang ditentukan. Jika tujuan lebih besar atau lebih kecil dari rentang sumber, sumber akan diulang atau dipotong. Perhatikan bahwa metode ini hanya menyalin format.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyFormatToRange(destination, 4, 6, 4, 6);

Parameter

Nama	Type	Deskripsi
`sheet`	`Sheet`	Sheet target.
`column`	`Integer`	Kolom pertama dari rentang target.
`columnEnd`	`Integer`	Kolom akhir dari rentang target.
`row`	`Integer`	Baris awal rentang target.
`rowEnd`	`Integer`	Baris akhir rentang target.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`copyTo(destination)`

Menyalin data dari rentang sel ke rentang sel lain. Nilai dan format disalin.

// The code below copies the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5);
rangeToCopy.copyTo(sheet.getRange(1, 6));

Parameter

Nama	Type	Deskripsi
`destination`	`Range`	Rentang tujuan untuk disalin; hanya posisi sel di kiri atas yang relevan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`copyTo(destination, copyPasteType, transposed)`

Menyalin data dari rentang sel ke rentang sel lain.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES,
false);

Parameter

Nama	Type	Deskripsi
`destination`	`Range`	Rentang tujuan untuk disalin; hanya posisi sel di kiri atas yang relevan.
`copyPasteType`	`CopyPasteType`	Jenis yang menentukan cara konten rentang ditempelkan ke tujuan.
`transposed`	`Boolean`	Apakah rentang harus ditempelkan dalam orientasi transposnya.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`copyTo(destination, options)`

Menyalin data dari rentang sel ke rentang sel lain. Secara default, nilai dan format disalin, tetapi ini dapat diganti menggunakan argumen lanjutan.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});

Parameter

Nama	Type	Deskripsi
`destination`	`Range`	Rentang tujuan untuk disalin; hanya posisi sel di kiri atas yang relevan.
`options`	`Object`	Objek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini.

Parameter lanjutan

Nama	Type	Deskripsi
`formatOnly`	`Boolean`	menetapkan bahwa hanya format yang harus disalin
`contentsOnly`	`Boolean`	menetapkan bahwa hanya konten yang harus disalin

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`

Menyalin konten rentang ke lokasi yang ditentukan. Jika tujuan lebih besar atau lebih kecil dari rentang sumber, sumber akan diulang atau dipotong.

Untuk deskripsi mendetail tentang parameter gridId, lihat getGridId().

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

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 0
range.copyValuesToRange(0, 4, 6, 4, 6);

Parameter

Nama	Type	Deskripsi
`gridId`	`Integer`	ID unik sheet dalam spreadsheet, terlepas dari posisinya.
`column`	`Integer`	Kolom pertama dari rentang target.
`columnEnd`	`Integer`	Kolom akhir dari rentang target.
`row`	`Integer`	Baris awal rentang target.
`rowEnd`	`Integer`	Baris akhir rentang target.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

Lihat juga

getGridId()

`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`

Menyalin konten rentang ke lokasi yang ditentukan. Jika tujuan lebih besar atau lebih kecil dari rentang sumber, sumber akan diulang atau dipotong.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyValuesToRange(destination, 4, 6, 4, 6);

Parameter

Nama	Type	Deskripsi
`sheet`	`Sheet`	Sheet target.
`column`	`Integer`	Kolom pertama dari rentang target.
`columnEnd`	`Integer`	Kolom akhir dari rentang target.
`row`	`Integer`	Baris awal rentang target.
`rowEnd`	`Integer`	Baris akhir rentang target.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createDataSourcePivotTable(dataSource)`

Membuat tabel pivot sumber data kosong dari sumber data, yang ditambatkan pada sel pertama dalam rentang ini.

Contoh ini menunjukkan cara membuat dan mengonfigurasi tabel pivot sumber data baru.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var pivotTable = anchorCell.createDataSourcePivotTable(dataSource);
pivotTable.addRowGroup('dataColumnA');
pivotTable.addColumnGroup('dataColumnB');
pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM);
pivotTable.addFilter('dataColumnA',
                     SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());

Parameter

Nama	Type	Deskripsi
`dataSource`	`DataSource`	Sumber data yang akan digunakan untuk membuat tabel pivot.

Return

DataSourcePivotTable — Tabel pivot sumber data yang baru dibuat.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createDataSourceTable(dataSource)`

Membuat tabel sumber data kosong dari sumber data, yang ditambatkan pada sel pertama dalam rentang ini.

Contoh ini menunjukkan cara membuat dan mengonfigurasi tabel sumber data baru.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var dataSourceTable = anchorCell.createDataSourceTable(dataSource);
    .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC')
    .addSortSpec('dataColumnA', /* ascending= *\/ true)
    .addSortSpec('dataColumnB', /* ascending= *\/ false);

Parameter

Nama	Type	Deskripsi
`dataSource`	`DataSource`	Sumber data yang akan digunakan untuk membuat tabel pivot.

Return

DataSourceTable — Tabel sumber data yang baru dibuat.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createDeveloperMetadataFinder()`

Menampilkan DeveloperMetadataFinderApi untuk menemukan metadata developer dalam cakupan rentang ini. Metadata berada dalam cakupan rentang hanya jika berada dalam rentang tersebut. Misalnya, metadata yang terkait dengan baris '3:3' tidak berada dalam cakupan 'A1:D5', tetapi berada dalam cakupan '1:5'.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

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

// Creates a developer metadata finder to search for metadata in the scope of this range.
const developerMetaDataFinder = range.createDeveloperMetadataFinder();

// Logs information about the developer metadata finder to the console.
const developerMetaData = developerMetaDataFinder.find()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

Return

DeveloperMetadataFinder — Pencari metadata developer untuk menelusuri metadata dalam cakupan rentang ini.

`createFilter()`

Membuat filter dan menerapkannya ke rentang yang ditentukan pada sheet. Anda tidak dapat membuat lebih dari satu filter pada sheet. Untuk mengakses dan mengubah filter setelah membuatnya, gunakan getFilter() atau Sheet.getFilter().

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");

// Creates a new filter and applies it to the range A1:C20 on the active sheet.
function createFilter() {
  range.createFilter();
}
// Gets the filter and applies criteria that only shows cells that aren't empty.
function getFilterAddCriteria() {
  let filter = range.getFilter();
  let criteria = SpreadsheetApp.newFilterCriteria()
    .whenCellNotEmpty()
    .build();
  filter.setColumnFilterCriteria(2, criteria);
}

Gunakan metode ini guna membuat filter untuk Grid sheet, yaitu jenis sheet default. Sheet petak adalah sheet yang tidak terhubung ke database. Untuk membuat jenis filter lainnya, lihat referensi berikut:

Buat filter tabel pivot dengan PivotTable.addFilter(sourceDataColumn, filterCriteria)
Buat filter untuk sheet yang terhubung ke database dengan DataSourceSheet.addFilter(columnName, filterCriteria)
Buat filter untuk tabel pivot yang terhubung ke database dengan DataSourcePivotTable.addFilter(columnName, filterCriteria)

Return

Filter — Filter baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createPivotTable(sourceData)`

Membuat tabel pivot kosong dari sourceData yang ditentukan dan didasarkan pada sel pertama dalam rentang ini.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A1 as a range in order to place the pivot table.
const range = sheet.getRange('A1');

// Gets the range of the source data for the pivot table.
const dataRange = sheet.getRange('E12:G20');

// Creates an empty pivot table from the specified source data.
const pivotTable = range.createPivotTable(dataRange);

// Logs the values from the pivot table's source data to the console.
console.log(pivotTable.getSourceDataRange().getValues());

Parameter

Nama	Type	Deskripsi
`sourceData`	`Range`	Data tempat tabel pivot akan dibuat.

Return

PivotTable — PivotTable yang baru dibuat.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`createTextFinder(findText)`

Membuat pencari teks untuk rentang, yang dapat menemukan dan mengganti teks di rentang ini.

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

// Creates  a text finder for the range.
var textFinder = range.createTextFinder('dog');

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

Parameter

Nama	Type	Deskripsi
`findText`	`String`	Teks yang akan ditelusuri.

Return

TextFinder — TextFinder untuk rentang

`deleteCells(shiftDimension)`

Menghapus rentang sel ini. Data yang ada di sheet di sepanjang dimensi yang diberikan digeser ke rentang yang dihapus.

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

var range = sheet.getRange("A1:D10");
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

Parameter

Nama	Type	Deskripsi
`shiftDimension`	`Dimension`	Dimensi yang akan digunakan untuk mengalihkan data yang ada.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`expandGroups()`

Memperluas grup yang diciutkan yang rentang atau tombol kontrolnya berpotongan dengan rentang ini. Lokasi tombol kontrol adalah indeks tempat tombol kontrol ditampilkan, langsung sebelum atau setelah grup bergantung pada setelan. Jika ada lebih dari satu grup di lokasi yang sama, grup yang paling dangkal akan diperluas.

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

// All row and column groups within the range are expanded.
range.expandGroups();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getA1Notation()`

Menampilkan deskripsi string rentang, dalam notasi A1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange(1, 1, 2, 5);

// Logs "A1:E2"
Logger.log(range.getA1Notation());

Return

String — Deskripsi string rentang dalam notasi A1.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getBackground()`

Menampilkan warna latar belakang sel kiri atas dalam rentang (misalnya, '#ffffff').

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

var cell = sheet.getRange("B5");
Logger.log(cell.getBackground());

Return

String — Kode warna latar belakang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getBackgroundObject()`

Menampilkan warna latar belakang sel kiri atas dalam rentang.

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

var cell = sheet.getRange("B5");
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

Return

Color — Warna latar belakang sel kiri atas dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getBackgroundObjects()`

Menampilkan warna latar belakang sel dalam rentang.

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

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgroundObjects();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j].asRgbColor().asHexString());
  }
}

Return

Color[][] — Array dua dimensi warna latar belakang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getBackgrounds()`

Menampilkan warna latar belakang sel dalam rentang (misalnya, '#ffffff').

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

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgrounds();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j]);
  }
}

Return

String[][] — Array dua dimensi kode warna latar belakang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getBandings()`

Menampilkan semua banding yang diterapkan ke sel mana pun dalam rentang ini.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets a range.
const range = sheet.getRange('A1:K50');

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

// Logs the second row color for each banding to the console.
for (let banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Return

Banding[] — Semua banding yang diterapkan ke sel mana pun dalam rentang ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getCell(row, column)`

Menampilkan sel tertentu dalam rentang.

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

var range = sheet.getRange("B2:D4");

// The row and column here are relative to the range
// getCell(1,1) in this code returns the cell at B2
var cell = range.getCell(1, 1);
Logger.log(cell.getValue());

Parameter

Nama	Type	Deskripsi
`row`	`Integer`	Baris sel relatif terhadap rentang.
`column`	`Integer`	Kolom sel relatif terhadap rentang.

Return

Range — Rentang yang berisi satu sel pada koordinat yang ditentukan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getColumn()`

Menampilkan posisi kolom awal untuk rentang ini.

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

var range = sheet.getRange("B2:D4");
// Logs "2.0"
Logger.log(range.getColumn());

Return

Integer — Posisi kolom awal rentang dalam spreadsheet.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDataRegion()`

Menampilkan salinan rentang yang diperluas dalam empat kardinal Direction untuk mencakup semua sel yang berdekatan dengan data di dalamnya. Jika rentang dikelilingi oleh sel kosong, tidak termasuk sel yang diagonal, rentang itu sendiri akan ditampilkan. Ini mirip dengan memilih rentang dan mengetik Ctrl+A di editor.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "B2:D4"
Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());

Return

Range — Region data rentang atau rentang untuk seluruh spreadsheet.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDataRegion(dimension)`

Menampilkan salinan rentang yang diperluas Direction.UP dan Direction.DOWN jika dimensi yang ditentukan adalah Dimension.ROWS, atau Direction.NEXT dan Direction.PREVIOUS jika dimensinya adalah Dimension.COLUMNS. Perluasan rentang ini didasarkan pada pendeteksian data di samping rentang yang diatur seperti tabel. Rentang yang diperluas mencakup semua sel yang berdekatan dengan data di dalamnya bersama dimensi yang ditentukan, termasuk batas tabel. Jika rentang asli dikelilingi oleh sel kosong di sepanjang dimensi yang ditentukan, rentang itu sendiri akan ditampilkan. Metode ini mirip dengan memilih rentang dan mengetik Ctrl+Space untuk kolom atau Shift+Space untuk baris di editor.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "C2:C4"
Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation());
// Logs "B3:D3"
Logger.log(
    sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());

Parameter

Nama	Type	Deskripsi
`dimension`	`Dimension`	Dimensi yang akan digunakan untuk memperluas rentang.

Return

Range — Region data rentang atau rentang yang mencakup setiap kolom atau setiap baris yang direntangkan oleh rentang asli.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDataSourceFormula()`

Menampilkan DataSourceFormula untuk sel pertama dalam rentang, atau null jika sel tidak berisi formula sumber data.

Return

DataSourceFormula — DataSourceFormula untuk sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDataSourceFormulas()`

Menampilkan DataSourceFormula untuk sel dalam rentang.

Return

DataSourceFormula[] — Array DataSourceFormula.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDataSourcePivotTables()`

Mendapatkan semua tabel pivot sumber data yang berpotongan dengan rentang.

Return

DataSourcePivotTable[] — Daftar tabel pivot sumber data.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDataSourceTables()`

Mendapatkan semua tabel sumber yang berpotongan dengan rentang.

Return

DataSourceTable[] — Daftar tabel sumber data.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDataSourceUrl()`

Menampilkan URL untuk data dalam rentang ini, yang dapat digunakan untuk membuat diagram dan kueri.

Code.gs

function doGet() {
  var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c');
  var sheet = ss.getSheetByName('ContinentData');
  var range = sheet.getRange('A1:B8');

  var template = HtmlService.createTemplateFromFile('piechart');
  template.dataSourceUrl = range.getDataSourceUrl();
  return template.evaluate();
}

diagram lingkaran.html

<!DOCTYPE html>
<html>
  <head>
    <!--Load the AJAX API-->
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      // Load the Visualization API and the corechart package.
      google.charts.load('current', {'packages': ['corechart']});

      // Set a callback to run when the Google Visualization API is loaded.
      google.charts.setOnLoadCallback(queryData);

      function queryData() {
        var query = new google.visualization.Query('<?= dataSourceUrl ?>');
        query.send(drawChart);
      }

      // Callback that creates and populates a data table,
      // instantiates the pie chart, passes in the data and
      // draws it.
      function drawChart(response) {
        if (response.isError()) {
          alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage());
          return;
        }
        var data = response.getDataTable();

        // Set chart options.
        var options = {
          title: 'Population by Continent',
          width: 400,
          height: 300
        };

        // Instantiate and draw the chart, passing in some options.
        var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <!-- Div that holds the pie chart. -->
    <div id="chart_div"></div>
  </body>
</html>

Return

String — URL untuk rentang ini sebagai sumber data yang dapat diteruskan ke API lain seperti diagram.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDataTable()`

Tampilkan data di dalam objek ini sebagai DataTable.

Return

DataTable — data sebagai tabel data.

`getDataTable(firstRowIsHeader)`

Menampilkan data di dalam rentang ini sebagai DataTable.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B7");

// Calling this method with "true" sets the first line to be the title of the axes
var datatable = range.getDataTable(true);

// Note that this doesn't build an EmbeddedChart, so you can't just use
// Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead.
var chart = Charts.newBarChart()
    .setDataTable(datatable)
    .setOption("title", "Your Title Here")
    .build();

Parameter

Nama	Type	Deskripsi
`firstRowIsHeader`	`Boolean`	Apakah memperlakukan baris pertama sebagai header.

Return

DataTable — Data sebagai tabel data.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDataValidation()`

Menampilkan aturan validasi data untuk sel kiri atas dalam rentang. Jika validasi data belum ditetapkan pada sel, metode ini akan menampilkan null.

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

Return

DataValidation — Aturan validasi data untuk sel kiri atas dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDataValidations()`

Menampilkan aturan validasi data untuk semua sel dalam rentang. Jika validasi data belum ditetapkan pada sel tertentu, metode ini akan menampilkan null untuk posisi sel tersebut dalam array.

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

Return

DataValidation[][] — Array dua dimensi untuk aturan validasi data yang terkait dengan sel dalam rentang tersebut.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDeveloperMetadata()`

Mendapatkan metadata developer yang terkait dengan rentang ini.

Return

DeveloperMetadata[] — Metadata developer yang terkait dengan rentang ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDisplayValue()`

Menampilkan nilai yang ditampilkan dari sel kiri atas dalam rentang. Nilainya adalah String. Nilai yang ditampilkan akan mempertimbangkan format pemformatan tanggal, waktu, dan mata uang, termasuk format yang diterapkan secara otomatis oleh setelan lokal spreadsheet. Sel kosong akan menampilkan string kosong.

Return

String — Nilai yang ditampilkan di sel ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getDisplayValues()`

Menampilkan petak nilai persegi panjang untuk rentang ini.

Menampilkan array dua dimensi dari nilai yang ditampilkan, diindeks oleh baris, lalu menurut kolom. Nilainya adalah objek String. Nilai yang ditampilkan memperhitungkan format tanggal, waktu, dan mata uang, termasuk format yang diterapkan secara otomatis oleh setelan lokalitas spreadsheet. Sel kosong diwakili oleh string kosong dalam array. Perlu diingat bahwa meskipun indeks rentang dimulai pada 1, 1, array JavaScript diindeks dari [0][0].

// The code below gets the displayed values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

Return

String[][] — Array nilai dua dimensi.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFilter()`

Menampilkan filter pada sheet yang memiliki rentang ini, atau null jika tidak ada filter pada sheet.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Gets the existing filter on the sheet that the given range belongs to.
let filter = range.getFilter();

Return

Filter — Filter.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontColorObject()`

Menampilkan warna font sel di sudut kiri atas rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontColorObject().asRgbColor().asHexString());

Return

Color — Warna font sel kiri atas dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontColorObjects()`

Menampilkan warna font sel dalam rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontColorObjects();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j].asRgbColor().asHexString());
  }
}

Return

Color[][] — Array dua dimensi warna font yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontFamilies()`

Menampilkan jenis font sel dalam rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontFamilies();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][] — Array dua dimensi dari jenis font yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontFamily()`

Menampilkan jenis font sel di sudut kiri atas rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontFamily());

Return

String — Jenis font sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontLine()`

Mendapatkan gaya garis sel di sudut kiri atas rentang ('underline', 'line-through', atau 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontLine());

Return

String — Garis font.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontLines()`

Mendapatkan gaya garis sel dalam rentang ('underline', 'line-through', atau 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontLines();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][] — Array dua dimensi garis font yang terkait dengan sel dalam rentang tersebut.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontSize()`

Menampilkan ukuran font dalam ukuran titik sel di pojok kiri atas rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontSize());

Return

Integer — Ukuran font dalam ukuran titik.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontSizes()`

Menampilkan ukuran font sel dalam rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontSizes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

Integer[][] — Array dua dimensi ukuran font teks yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontStyle()`

Menampilkan gaya font ('italic' atau 'normal') sel di pojok kiri atas rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontStyle());

Return

String — Gaya font teks dalam sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontStyles()`

Menampilkan gaya font sel dalam rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontStyles();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][] — Array dua dimensi gaya font teks yang terkait dengan sel dalam rentang itu.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontWeight()`

Menampilkan ketebalan font (normal/tebal) sel di sudut kiri atas rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontWeight());

Return

String — Ketebalan font teks dalam sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontWeights()`

Menampilkan ketebalan font sel dalam rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontWeights();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][] — Array dua dimensi dari ketebalan font teks yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFormula()`

Menampilkan formula (notasi A1) untuk sel kiri atas rentang, atau string kosong jika sel kosong atau tidak berisi formula.

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

// This assumes you have a function in B5 that sums up
// B2:B4
var range = sheet.getRange("B5");

// Logs the calculated value and the formula
Logger.log("Calculated value: %s Formula: %s",
           range.getValue(),
           range.getFormula());

Return

String — Formula untuk sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFormulaR1C1()`

Menampilkan formula (notasi R1C1) untuk sel tertentu, atau null jika tidak ada.

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

var range = sheet.getRange("B5");
var formula = range.getFormulaR1C1();
Logger.log(formula);

Return

String — Formula dalam notasi R1C1.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFormulas()`

Menampilkan formula (notasi A1) untuk sel dalam rentang. Entri dalam array 2D adalah string kosong untuk sel tanpa formula.

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

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulas();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

Return

String[][] — Array formula dua dimensi dalam format string.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFormulasR1C1()`

Menampilkan formula (notasi R1C1) untuk sel dalam rentang. Entri dalam array 2D adalah null untuk sel tanpa formula.

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

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulasR1C1();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

Return

String[][] — Array formula dua dimensi dalam notasi R1C1.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getGridId()`

Menampilkan ID petak sheet induk rentang. ID adalah nilai int non-negatif acak.

// Log the grid ID of the first sheet (by tab position) in the spreadsheet.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getGridId());

Return

Integer — ID petak sheet induk.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getHeight()`

Menampilkan tinggi rentang.

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

var range = sheet.getRange("B2:D4");
// logs 3.0
Logger.log(range.getHeight());

Return

Integer — Tinggi rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getHorizontalAlignment()`

Menampilkan perataan horizontal teks (kiri/tengah/kanan) sel di pojok kiri atas rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getHorizontalAlignment());

Return

String — Perataan horizontal teks dalam sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getHorizontalAlignments()`

Menampilkan perataan horizontal sel dalam rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getHorizontalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][] — Array dua dimensi dari perataan horizontal teks yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getLastColumn()`

Menampilkan posisi kolom akhir.

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

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastColumn());

Return

Integer — Posisi kolom akhir rentang dalam spreadsheet.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getLastRow()`

Menampilkan posisi baris akhir.

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

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastRow());

Return

Integer — Posisi baris akhir rentang dalam spreadsheet.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getMergedRanges()`

Menampilkan array objek Range yang merepresentasikan sel gabungan yang sepenuhnya berada dalam rentang saat ini, atau berisi setidaknya satu sel dalam rentang saat ini.

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

var range = sheet.getRange("A1:B3");

var mergedRanges = range.getMergedRanges();
for (var i = 0; i < mergedRanges.length; i++) {
  Logger.log(mergedRanges[i].getA1Notation());
  Logger.log(mergedRanges[i].getDisplayValue());
}

Return

Range[] — Array objek Range, yang mewakili sel gabungan yang tumpang tindih dengan rentang.

`getNextDataCell(direction)`

Mulai dari sel di kolom dan baris pertama rentang, menampilkan sel berikutnya di arah yang diberikan yang merupakan tepi dari rentang sel yang berdekatan dengan data di dalamnya atau sel di tepi spreadsheet dalam arah tersebut. Ini sama dengan mengetik Ctrl+[arrow key] di editor.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("C3:E5");
// Logs "C1"
Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());

Parameter

Nama	Type	Deskripsi
`direction`	`Direction`	Arah untuk menemukan sel tepi region data berikutnya.

Return

Range — Sel tepi region data atau sel di tepi spreadsheet.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getNote()`

Menampilkan catatan yang terkait dengan rentang tertentu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getNote());

Return

String — Catatan yang terkait dengan sel tertentu.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getNotes()`

Menampilkan catatan yang terkait dengan sel dalam rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getNotes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][] — Array dua dimensi untuk catatan yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getNumColumns()`

Menampilkan jumlah kolom dalam rentang ini.

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

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumColumns());

Return

Integer — Jumlah kolom dalam rentang ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getNumRows()`

Menampilkan jumlah baris dalam rentang ini.

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

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumRows());

Return

Integer — Jumlah baris dalam rentang ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getNumberFormat()`

Mendapatkan pemformatan angka atau tanggal dari sel kiri atas rentang yang ditentukan. Pola format yang ditampilkan dijelaskan dalam dokumentasi Sheets API.

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

var cell = sheet.getRange("C4");
Logger.log(cell.getNumberFormat());

Return

String — Format angka sel kiri atas rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getNumberFormats()`

Menampilkan format angka atau tanggal untuk sel dalam rentang. Pola format yang ditampilkan dijelaskan dalam dokumentasi Sheets API.

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

var range = sheet.getRange("B5:C6");
var formats = range.getNumberFormats();
for (var i in formats) {
  for (var j in formats[i]) {
    Logger.log(formats[i][j]);
  }
}

Return

String[][] — Array dua dimensi dari format angka.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getRichTextValue()`

Menampilkan nilai Rich Text untuk sel kiri atas rentang, atau null jika nilai sel bukan teks.

// Gets the Rich Text value of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var richText = range.getRichTextValue();
console.log(richText.getText());

Return

RichTextValue — Nilai Teks Kaya pada sel kiri atas dalam rentang, atau null jika nilai sel bukan teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getRichTextValues()`

Menampilkan nilai Rich Text untuk sel dalam rentang itu.

// Gets the Rich Text values for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var values = range.getRichTextValues();

for (var i = 0; i < values.length; i++) {
  for (var j = 0; j < values[i].length; j++) {
    console.log(values[i][j].getText());
  }
}

Return

RichTextValue[][] — Array dua dimensi dari nilai Rich Text.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getRow()`

Menampilkan posisi baris untuk rentang ini. Serupa dengan getRowIndex().

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

var range = sheet.getRange("B2");
Logger.log(range.getRow());

Return

Integer — Posisi baris rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getRowIndex()`

Menampilkan posisi baris untuk rentang ini. Serupa dengan getRow().

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

var range = sheet.getRange("B2");
Logger.log(range.getRowIndex());

Return

Integer — Posisi baris rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

Lihat juga

getRow()

`getSheet()`

Menampilkan sheet yang mencakup rentang ini.

Return

Sheet — Sheet yang memiliki rentang ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getTextDirection()`

Menampilkan arah teks untuk sel kiri atas rentang. Menampilkan null jika arah teks sel ditentukan dengan deteksi otomatis.

// Get the text direction of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getTextDirection());

Return

TextDirection — Arah teks sel kiri atas dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getTextDirections()`

Menampilkan arah teks untuk sel dalam rentang. Entri dalam array 2D adalah null untuk sel yang menggunakan deteksi otomatis.

// Get the text directions for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var directions = range.getTextDirections();

for (var i = 0; i < directions.length; i++) {
  for (var j = 0; j < directions[i].length; j++) {
    Logger.log(directions[i][j]);
  }
}

Return

TextDirection[][] — Array dua dimensi dari rute teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getTextRotation()`

Menampilkan pengaturan rotasi teks untuk sel kiri atas rentang.

// Log the text rotation settings for a cell.
var sheet = SpreadsheetApp.getActiveSheet();

var cell = sheet.getRange("A1");
Logger.log(cell.getTextRotation());

Return

TextRotation — Pengaturan rotasi teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getTextRotations()`

Menampilkan pengaturan rotasi teks untuk sel dalam rentang.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

var results = range.getTextRotations();

for (var i in results) {
  for (var j in results[i]) {
    var rotation = results[i][j];
    Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation);
  }
}

Return

TextRotation[][] — Array rotasi dua dimensi yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getTextStyle()`

Menampilkan gaya teks untuk sel kiri atas rentang.

// Get the text style of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var style = range.getTextStyle();
Logger.log(style);

Return

TextStyle — Gaya teks sel kiri atas dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getTextStyles()`

Menampilkan gaya teks untuk sel dalam rentang tersebut.

// Get the text styles for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var styles = range.getTextStyles();

for (var i = 0; i < styles.length; i++) {
  for (var j = 0; j < styles[i].length; j++) {
    Logger.log(styles[i][j]);
  }
}

Return

TextStyle[][] — Array dua dimensi gaya teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getValue()`

Menampilkan nilai sel kiri atas dalam rentang. Nilainya dapat berupa jenis Number, Boolean, Date, atau String bergantung pada nilai sel. Sel kosong akan menampilkan string kosong.

Return

Object — Nilai dalam sel ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getValues()`

Menampilkan petak nilai persegi panjang untuk rentang ini.

Menampilkan array nilai dua dimensi, yang diindeks menurut baris, lalu menurut kolom. Nilainya dapat berjenis Number, Boolean, Date, atau String, bergantung pada nilai sel. Sel kosong diwakili oleh string kosong dalam array. Perlu diingat bahwa meskipun indeks rentang dimulai pada 1, 1, array JavaScript diindeks dari [0][0].

// The code below gets the values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);

Di aplikasi web, nilai Date bukan parameter hukum. getValues() gagal menampilkan data ke aplikasi web jika rentang berisi sel dengan nilai Date. Sebagai gantinya, ubah semua nilai yang diambil dari sheet menjadi primitif JavaScript yang didukung seperti Number, Boolean, atau String.

Return

Object[][] — Array nilai dua dimensi.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getVerticalAlignment()`

Menampilkan perataan vertikal (atas/tengah/bawah) sel di pojok kiri atas rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getVerticalAlignment());

Return

String — Perataan vertikal teks dalam sel.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getVerticalAlignments()`

Menampilkan perataan vertikal sel dalam rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][] — Array dua dimensi dari perataan vertikal teks yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getWidth()`

Menampilkan lebar rentang dalam kolom.

Return

Integer — Jumlah kolom dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getWrap()`

Menampilkan apakah teks dalam sel digabungkan. Untuk mendapatkan strategi penggabungan yang lebih terperinci, gunakan getWrapStrategy().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getWrap());

Return

Boolean — Apakah teks dalam sel ini digabungkan atau tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getWrapStrategies()`

Menampilkan strategi pengemasan teks untuk sel dalam rentang.

// Get the text wrapping strategies for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var strategies = range.getWrapStrategies();

for (var i = 0; i < strategies.length; i++) {
  for (var j = 0; j < strategies[i].length; j++) {
    Logger.log(strategies[i][j]);
  }
}

Return

WrapStrategy[][] — Array dua dimensi dari strategi pengemasan teks.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getWrapStrategy()`

Menampilkan strategi pengemasan teks untuk sel kiri atas rentang.

// Get the text wrapping strategy of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getWrapStrategy());

Return

WrapStrategy — Strategi pengemasan teks dari sel kiri atas dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getWraps()`

Menampilkan apakah teks dalam sel digabungkan. Untuk mendapatkan strategi penggabungan yang lebih terperinci, gunakan getWrapStrategies().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    var isWrapped = results[i][j];
    if (isWrapped) {
       Logger.log("Cell [%s, %s] has wrapped text", i, j);
    }
  }
}

Return

Boolean[][] — Array dua dimensi dari perataan vertikal teks yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`insertCells(shiftDimension)`

Menyisipkan sel kosong ke rentang ini. Sel baru mempertahankan pemformatan apa pun yang ada dalam sel yang sebelumnya menempati rentang ini. Data yang ada di sheet di sepanjang dimensi yang diberikan dialihkan dari rentang yang disisipkan.

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

var range = sheet.getRange("A1:D10");
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

Parameter

Nama	Type	Deskripsi
`shiftDimension`	`Dimension`	Dimensi yang akan digunakan untuk mengalihkan data yang ada.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`insertCheckboxes()`

Menyisipkan kotak centang ke dalam setiap sel dalam rentang, yang dikonfigurasi dengan true untuk dicentang dan false untuk tidak dicentang. Menetapkan nilai semua sel dalam rentang ke false.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'false'.
range.insertCheckboxes();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`insertCheckboxes(checkedValue)`

Menyisipkan kotak centang ke dalam setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk dicentang dan string kosong untuk tidak dicentang. Menetapkan nilai setiap sel dalam rentang ke string kosong.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the range A1:B10 to
//  the empty string.
range.insertCheckboxes('yes');

Parameter

Nama	Type	Deskripsi
`checkedValue`	`Object`	Nilai yang divalidasi untuk validasi data kotak centang.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`insertCheckboxes(checkedValue, uncheckedValue)`

Menyisipkan kotak centang ke dalam setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk status yang dicentang dan tidak dicentang. Menetapkan nilai setiap sel dalam rentang ke nilai kustom yang tidak dicentang.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'no'.
range.insertCheckboxes('yes', 'no');

Parameter

Nama	Type	Deskripsi
`checkedValue`	`Object`	Nilai yang divalidasi untuk validasi data kotak centang.
`uncheckedValue`	`Object`	Nilai untuk validasi data kotak centang yang tidak dicentang.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`isBlank()`

Menampilkan true jika rentang benar-benar kosong.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.isBlank());

Return

Boolean — true jika rentang kosong; false jika tidak ada.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`isChecked()`

Menampilkan apakah semua sel dalam rentang memiliki status kotak centang sebagai 'dicentang'. Menampilkan null jika beberapa sel dicentang dan sisanya tidak dicentang, atau jika beberapa sel tidak memiliki validasi data kotak centang.

var range = SpreadsheetApp.getActive().getRange('A1:A3');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:A3.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Sets the value of isRange1Checked as true as it contains the checked value.
var isRange1Checked = range1.isChecked();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('no');
// Sets the value of isRange2Checked as false as it contains the unchecked value.
var isRange2Checked = range2.isChecked();

var range3 = SpreadsheetApp.getActive().getRange('A3');
range3.setValue('random');
// Sets the value of isRange3Checked as null, as it contains an invalid checkbox value.
var isRange3Checked = range3.isChecked();

Return

Boolean — true, jika semua sel dalam rentang dicentang, false jika semua sel dalam rentang tidak dicentang, atau null jika salah satu sel tidak dicentang atau tidak memiliki validasi data kotak centang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`isEndColumnBounded()`

Menentukan apakah akhir rentang terikat dengan kolom tertentu. Misalnya, untuk rentang A1:B10 atau B:B, yang terikat dengan kolom di akhir rentang, metode ini akan menampilkan true; untuk rentang 3:7 atau A1:5, yang hanya terikat dengan baris tertentu di akhir rentang, metode ini akan menampilkan false.

Return

Boolean — true jika akhir rentang terikat ke kolom tertentu; false jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`isEndRowBounded()`

Menentukan apakah akhir rentang terikat dengan baris tertentu. Misalnya, untuk rentang A1:B10 atau 3:7, yang terikat dengan baris di akhir rentang, metode ini menampilkan true; untuk rentang B:B atau A1:C, yang hanya terikat ke kolom tertentu di akhir rentang, metode ini menampilkan false.

Return

Boolean — true jika akhir rentang terikat ke baris tertentu; false jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`isPartOfMerge()`

Menampilkan true jika sel dalam rentang saat ini tumpang-tindih dengan sel gabungan.

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

var range = sheet.getRange("A1:B3");

// True if any of the cells in A1:B3 is included in a merge.
var isPartOfMerge = range.isPartOfMerge();

Return

Boolean — true jika rentang tumpang-tindih dengan sel yang digabungkan, jika tidak, false akan ditampilkan.

`isStartColumnBounded()`

Menentukan apakah awal rentang terikat ke kolom tertentu. Misalnya, untuk rentang A1:B10 atau B:B, yang terikat dengan kolom di awal rentang, metode ini akan menampilkan true; untuk rentang 3:7, yang hanya terikat dengan baris di awal rentang, metode ini akan menampilkan false.

Return

Boolean — true jika awal rentang terikat ke kolom tertentu; false jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`isStartRowBounded()`

Menentukan apakah awal rentang terikat ke baris tertentu. Misalnya, untuk rentang A1:B10 atau 3:7, yang terikat dengan baris di awal rentang, metode ini akan menampilkan true; untuk rentang B:B, yang hanya terikat ke kolom tertentu di awal rentang, metode ini akan menampilkan false.

Return

Boolean — true jika awal rentang terikat ke baris tertentu; false jika tidak.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`merge()`

Menggabungkan sel dalam rentang menjadi satu blok.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below 2-dimensionally merges the cells in A1 to B3
sheet.getRange('A1:B3').merge();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`mergeAcross()`

Gabungkan sel dalam rentang di seluruh kolom rentang.

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

// The code below merges cells C5:E5 into one cell
var range1 = sheet.getRange("C5:E5");
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
var range2 = sheet.getRange("F5:H6");
range2.mergeAcross();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`mergeVertically()`

Menggabungkan sel dalam rentang.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below vertically merges the cells in A1 to A10
sheet.getRange('A1:A10').mergeVertically();

// The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10
sheet.getRange('B1:D10').mergeVertically();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`moveTo(target)`

Potong dan tempel (format dan nilai) dari rentang ini ke rentang target.

// The code below moves the first 5 columns over to the 6th column
var sheet = SpreadsheetApp.getActiveSheet()
sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));

Parameter

Nama	Type	Deskripsi
`target`	`Range`	Rentang target untuk menyalin rentang ini; hanya posisi sel kiri atas yang relevan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`offset(rowOffset, columnOffset)`

Menampilkan rentang baru yang diimbangi dari rentang ini dengan jumlah baris dan kolom tertentu (yang dapat negatif). Rentang yang baru memiliki ukuran yang sama dengan rentang aslinya.

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

var cell = sheet.getRange("A1");

// newCell references B2
var newCell = cell.offset(1, 1);

Parameter

Nama	Type	Deskripsi
`rowOffset`	`Integer`	Jumlah baris dari sel kiri atas rentang; nilai negatif mewakili baris dari sel kiri atas rentang.
`columnOffset`	`Integer`	Jumlah kolom langsung dari sel kiri atas rentang; nilai negatif mewakili kolom yang tersisa dari sel kiri atas rentang.

Return

Range — Rentang ini, untuk perantaian.

`offset(rowOffset, columnOffset, numRows)`

Menampilkan rentang baru yang relatif terhadap rentang saat ini, yang titik kiri atasnya di-offset dari rentang saat ini oleh baris dan kolom tertentu, dan dengan tinggi yang diberikan dalam sel.

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

var cell = sheet.getRange("A1");

// newCell references B2:B3
var newRange = cell.offset(1, 1, 2);

Parameter

Nama	Type	Deskripsi
`rowOffset`	`Integer`	Jumlah baris dari sel kiri atas rentang; nilai negatif mewakili baris dari sel kiri atas rentang.
`columnOffset`	`Integer`	Jumlah kolom langsung dari sel kiri atas rentang; nilai negatif mewakili kolom yang tersisa dari sel kiri atas rentang.
`numRows`	`Integer`	Tinggi baris di rentang rentang baru.

Return

Range — Rentang ini, untuk perantaian.

`offset(rowOffset, columnOffset, numRows, numColumns)`

Menampilkan rentang baru yang relatif terhadap rentang saat ini, yang titik kiri atasnya di-offset dari rentang saat ini oleh baris dan kolom yang diberikan, dan dengan tinggi dan lebar yang ditentukan dalam sel.

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

var cell = sheet.getRange("A1");

// newCell references B2:C3
var newRange = cell.offset(1, 1, 2, 2);

Parameter

Nama	Type	Deskripsi
`rowOffset`	`Integer`	Jumlah baris dari sel kiri atas rentang; nilai negatif mewakili baris dari sel kiri atas rentang.
`columnOffset`	`Integer`	Jumlah kolom langsung dari sel kiri atas rentang; nilai negatif mewakili kolom yang tersisa dari sel kiri atas rentang.
`numRows`	`Integer`	Tinggi baris di rentang rentang baru.
`numColumns`	`Integer`	Lebar dalam kolom rentang baru.

Return

Range — Rentang ini, untuk perantaian.

`protect()`

Membuat objek yang dapat melindungi rentang agar tidak dapat diedit, kecuali oleh pengguna yang memiliki izin. Hingga skrip benar-benar mengubah daftar editor untuk rentang tersebut (dengan memanggil Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses), atau menetapkan nilai baru untuk Protection.setDomainEdit(editable)), izin tersebut akan mencerminkan spreadsheet itu sendiri, yang secara efektif berarti rentang tersebut tidak dilindungi. Jika rentang tersebut sudah dilindungi, metode ini akan membuat rentang dilindungi baru yang tumpang tindih dengan rentang yang ada. Jika sel dilindungi oleh beberapa rentang yang dilindungi dan salah satu di antaranya mencegah pengguna tertentu mengedit sel, pengguna tersebut tidak diizinkan untuk mengedit sel.

// Protect range A1:B10, then remove all other users from the list of editors.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var protection = range.protect().setDescription('Sample protected range');

// 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);
}

Return

Protection — Objek yang merepresentasikan setelan perlindungan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`randomize()`

Mengacak urutan baris dalam rentang yang diberikan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Randomizes the range
range.randomize();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`removeCheckboxes()`

Menghapus semua kotak centang dari rentang. Menghapus validasi data dari setiap sel, dan juga menghapus nilainya jika sel berisi nilai yang dicentang atau tidak dicentang.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('random');
// Removes the checkbox data validation in cell A2 but does not clear its value.
range2.removeCheckboxes();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`removeDuplicates()`

Menghapus baris dalam rentang ini yang berisi nilai yang merupakan duplikat nilai pada baris sebelumnya. Baris dengan nilai yang identik namun memiliki perbedaan kapitalisasi, pemformatan, atau formula akan dianggap duplikat. Metode ini juga menghapus baris duplikat yang disembunyikan dari tampilan (misalnya, karena adanya filter). Konten di luar rentang ini tidak dihapus.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove duplicate rows in the range.
range.removeDuplicates();

Return

Range — Rentang yang dihasilkan setelah menghapus duplikat. Ukuran rentang dikurangi dengan baris untuk setiap baris yang dihapus.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`removeDuplicates(columnsToCompare)`

Menghapus baris dalam rentang ini yang berisi nilai di kolom tertentu yang merupakan duplikat nilai dari baris sebelumnya. Baris dengan nilai yang identik namun memiliki perbedaan kapitalisasi, pemformatan, atau formula akan dianggap duplikat. Metode ini juga menghapus baris duplikat yang disembunyikan dari tampilan (misalnya, karena adanya filter). Konten di luar rentang ini tidak dihapus.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove rows which have duplicate values in column B.
range.removeDuplicates([2]);

// Remove rows which have duplicate values in both columns B and D.
range.removeDuplicates([2,4]);

Parameter

Nama	Type	Deskripsi
`columnsToCompare`	`Integer[]`	Kolom yang akan dianalisis untuk mendeteksi nilai duplikat. Jika tidak ada kolom yang disediakan, semua kolom akan dianalisis untuk mendeteksi duplikat.

Return

Range — Rentang yang dihasilkan setelah menghapus duplikat. Ukuran rentang dikurangi dengan baris untuk setiap baris yang dihapus.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setBackground(color)`

Menetapkan warna latar belakang semua sel dalam rentang dalam notasi CSS (seperti '#ffffff' atau 'white').

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

var range = sheet.getRange("B2:D5");
range.setBackground("red");

Parameter

Nama	Type	Deskripsi
`color`	`String`	Kode warna dalam notasi CSS (seperti `'#ffffff'` atau `'white'`); nilai `null` akan mereset warna.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setBackgroundObject(color)`

Menetapkan warna latar belakang semua sel dalam rentang.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var bgColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();

var range = sheet.getRange("B2:D5");
range.setBackgroundObject(bgColor);

Parameter

Nama	Type	Deskripsi
`color`	`Color`	Warna latar belakang yang akan disetel; nilai `null` mereset warna latar belakang.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setBackgroundObjects(color)`

Menetapkan petak persegi panjang warna latar belakang (harus cocok dengan dimensi rentang ini).

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

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setBackgroundObjects(colors);

Parameter

Nama	Type	Deskripsi
`color`	`Color[][]`	Array warna dua dimensi; nilai `null` akan mereset warna.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setBackgroundRGB(red, green, blue)`

Menetapkan latar belakang ke warna tertentu menggunakan nilai RGB (bilangan bulat antara 0 dan 255 inklusif).

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

var cell = sheet.getRange("B2");

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

Parameter

Nama	Type	Deskripsi
`red`	`Integer`	Nilai merah dalam notasi RGB.
`green`	`Integer`	Nilai hijau dalam notasi RGB.
`blue`	`Integer`	Nilai biru dalam notasi RGB.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setBackgrounds(color)`

Menetapkan petak persegi panjang warna latar belakang (harus cocok dengan dimensi rentang ini). Warna dalam notasi CSS (seperti '#ffffff' atau 'white').

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

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setBackgrounds(colors);

Parameter

Nama	Type	Deskripsi
`color`	`String[][]`	Array warna dua dimensi dalam notasi CSS (seperti `'#ffffff'` atau `'white'`); nilai `null` mereset warna.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setBorder(top, left, bottom, right, vertical, horizontal)`

Menetapkan properti batas. Nilai yang valid adalah true (aktif), false (nonaktif), dan null (tidak ada perubahan).

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

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.setBorder(true, null, true, null, false, false);

Parameter

Nama	Type	Deskripsi
`top`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`left`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`bottom`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`right`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`vertical`	`Boolean`	`true` untuk batas vertikal internal, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`horizontal`	`Boolean`	`true` untuk batas horizontal internal, `false` untuk tidak ada, `null` untuk tidak ada perubahan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`

Menetapkan properti batas dengan warna dan/atau gaya. Nilai yang valid adalah true (aktif), false (nonaktif), dan null (tidak ada perubahan). Untuk warna, gunakan Warna dalam notasi CSS (seperti '#ffffff' atau 'white').

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

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);

Parameter

Nama	Type	Deskripsi
`top`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`left`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`bottom`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`right`	`Boolean`	`true` untuk batas, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`vertical`	`Boolean`	`true` untuk batas vertikal internal, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`horizontal`	`Boolean`	`true` untuk batas horizontal internal, `false` untuk tidak ada, `null` untuk tidak ada perubahan.
`color`	`String`	Warna dalam notasi CSS (seperti `'#ffffff'` atau `'white'`), `null` untuk warna default (hitam).
`style`	`BorderStyle`	Gaya untuk batas, `null` untuk gaya default (padat).

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setDataValidation(rule)`

Menetapkan satu aturan validasi data untuk semua sel dalam rentang.

// Set the data validation rule for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parameter

Nama	Type	Deskripsi
`rule`	`DataValidation`	Aturan validasi data yang akan ditetapkan, atau `null` untuk menghapus validasi data.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setDataValidations(rules)`

Menetapkan aturan validasi data untuk semua sel dalam rentang. Metode ini menggunakan array validasi data dua dimensi, diindeks menurut baris, lalu menurut kolom. Dimensi array harus sesuai dengan dimensi rentang.

// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10.
var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
var rules = destinationRange.getDataValidations();
for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

Parameter

Nama	Type	Deskripsi
`rules`	`DataValidation[][]`	Array aturan dimensi data dua dimensi yang akan ditetapkan; nilai `null` akan menghapus validasi data.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontColor(color)`

Menetapkan warna font dalam notasi CSS (seperti '#ffffff' atau 'white').

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

var cell = sheet.getRange("B2");
cell.setFontColor("red");

Parameter

Nama	Type	Deskripsi
`color`	`String`	Warna font dalam notasi CSS (seperti `'#ffffff'` atau `'white'`); nilai `null` akan mereset warna.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontColorObject(color)`

Menetapkan warna font dari rentang yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();

var cell = sheet.getRange("B2");
cell.setFontColor(color);

Parameter

Nama	Type	Deskripsi
`color`	`Color`	Warna font yang akan ditetapkan; nilai `null` akan mereset warna.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontColorObjects(colors)`

Menetapkan petak persegi panjang warna font (harus cocok dengan dimensi rentang ini).

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

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setFontColorObjects(colors);

Parameter

Nama	Type	Deskripsi
`colors`	`Color[][]`	Array warna dua dimensi; nilai `null` akan mereset warna font.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontColors(colors)`

Menetapkan petak persegi panjang warna font (harus cocok dengan dimensi rentang ini). Warna menggunakan notasi CSS (seperti '#ffffff' atau 'white').

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

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setFontColors(colors);

Parameter

Nama	Type	Deskripsi
`colors`	`Object[][]`	Array warna dua dimensi dalam notasi CSS (seperti `'#ffffff'` atau `'white'`); nilai `null` mereset warna.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontFamilies(fontFamilies)`

Menetapkan petak persegi panjang jenis font (harus cocok dengan dimensi rentang ini). Contoh jenis font adalah " favicon" atau "H fresco".

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

var fonts = [
  ["Arial", "Helvetica", "Verdana"],
  ["Courier New", "Arial", "Helvetica]
];

var cell = sheet.getRange("B2:D3");
cell.setFontFamilies(fonts);

Parameter

Nama	Type	Deskripsi
`fontFamilies`	`Object[][]`	Array dua dimensi jenis font; nilai `null` akan mereset jenis font.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontFamily(fontFamily)`

Menetapkan jenis font, seperti " infografis" atau "Hshader".

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

var cell = sheet.getRange("B2");
cell.setFontFamily("Helvetica");

Parameter

Nama	Type	Deskripsi
`fontFamily`	`String`	Jenis font yang akan ditetapkan; nilai `null` akan mereset jenis font.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontLine(fontLine)`

Menetapkan gaya garis font dari rentang yang ditentukan ('underline', 'line-through', atau 'none').

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

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

Parameter

Nama	Type	Deskripsi
`fontLine`	`String`	Gaya garis font, `'underline'`, `'line-through'`, atau `'none'`; nilai `null` akan mereset gaya garis font.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontLines(fontLines)`

Menetapkan petak persegi panjang gaya garis (harus sesuai dengan dimensi rentang ini).

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

// The size of the two-dimensional array must match the size of the range.
var fontLines = [
  ["underline", "line-through", "none"]
];

var range = sheet.getRange("B2:D2");
range.setFontLines(fontLines);

Parameter

Nama	Type	Deskripsi
`fontLines`	`Object[][]`	Array dua dimensi untuk gaya garis font (`'underline'`, `'line-through'`, atau `'none'`); nilai `null` mereset gaya garis font.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontSize(size)`

Menetapkan ukuran font, dengan ukuran menjadi ukuran titik yang akan digunakan.

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

var cell = sheet.getRange("B2");
cell.setFontSize(20);

Parameter

Nama	Type	Deskripsi
`size`	`Integer`	Ukuran font dalam ukuran titik.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontSizes(sizes)`

Menetapkan petak persegi panjang ukuran font (harus cocok dengan dimensi rentang ini). Ukurannya berupa titik.

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

// The size of the two-dimensional array must match the size of the range.
var fontSizes = [
  [16, 20, 24]
];

var range = sheet.getRange("B2:D2");
range.setFontSizes(fontSizes);

Parameter

Nama	Type	Deskripsi
`sizes`	`Object[][]`	Array ukuran dua dimensi.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontStyle(fontStyle)`

Menetapkan gaya font untuk rentang yang ditentukan ('italic' atau 'normal').

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

var cell = sheet.getRange("B2");
cell.setFontStyle("italic");

Parameter

Nama	Type	Deskripsi
`fontStyle`	`String`	Gaya font, `'italic'` atau `'normal'`; nilai `null` akan mereset gaya font.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontStyles(fontStyles)`

Menetapkan petak persegi panjang gaya font (harus cocok dengan dimensi rentang ini).

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

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

Parameter

Nama	Type	Deskripsi
`fontStyles`	`Object[][]`	Array dua dimensi untuk gaya font, `'italic'` atau `'normal'`; nilai `null` mereset gaya font.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontWeight(fontWeight)`

Menetapkan ketebalan font untuk rentang tertentu (normal/tebal).

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

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

Parameter

Nama	Type	Deskripsi
`fontWeight`	`String`	Ketebalan font, baik `'bold'` atau `'normal'`; nilai `null` akan mereset ketebalan font.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFontWeights(fontWeights)`

Menetapkan petak persegi panjang ketebalan font (harus cocok dengan dimensi rentang ini). Contoh ketebalan font adalah "tebal".

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

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  [ "bold", "bold", "normal" ]
];

var range = sheet.getRange("B2:D2");
range.setFontWeights(fontStyles);

Parameter

Nama	Type	Deskripsi
`fontWeights`	`Object[][]`	Array dua dimensi dari ketebalan font, baik `'bold'` atau `'normal'`; nilai `null` mereset ketebalan font.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFormula(formula)`

Memperbarui formula untuk rentang ini. Formula yang diberikan harus dalam notasi A1.

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

var cell = sheet.getRange("B5");
cell.setFormula("=SUM(B3:B4)");

Parameter

Nama	Type	Deskripsi
`formula`	`String`	String yang mewakili formula yang akan ditetapkan untuk sel.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFormulaR1C1(formula)`

Memperbarui formula untuk rentang ini. Formula yang diberikan harus dalam notasi R1C1.

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

var cell = sheet.getRange("B5");
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");

Parameter

Nama	Type	Deskripsi
`formula`	`String`	Formula string.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFormulas(formulas)`

Menetapkan petak persegi panjang formula (harus cocok dengan dimensi rentang ini). Formula yang diberikan harus berada dalam notasi A1. Metode ini menggunakan array formula dua dimensi, yang diindeks berdasarkan baris, lalu menurut kolom. Dimensi array harus sesuai dengan dimensi rentang.

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

// This sets the formulas to be a row of sums, followed by a row of averages right below.
// The size of the two-dimensional array must match the size of the range.
var formulas = [
  ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"],
  ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"]
];

var cell = sheet.getRange("B5:D6");
cell.setFormulas(formulas);

Parameter

Nama	Type	Deskripsi
`formulas`	`String[][]`	Array string dua dimensi formula.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setFormulasR1C1(formulas)`

Menetapkan petak persegi panjang formula (harus cocok dengan dimensi rentang ini). Formula yang diberikan harus berada dalam notasi R1C1.

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

// This creates formulas for a row of sums, followed by a row of averages.
var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])";
var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])";

// The size of the two-dimensional array must match the size of the range.
var formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove]
];

var cell = sheet.getRange("B5:D6");
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

Parameter

Nama	Type	Deskripsi
`formulas`	`String[][]`	Array formula dua dimensi dalam format R1C1.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setHorizontalAlignment(alignment)`

Menetapkan perataan horizontal (kiri ke kanan) untuk rentang tertentu (kiri/tengah/kanan).

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

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

Parameter

Nama	Type	Deskripsi
`alignment`	`String`	Perataan, baik `'left'`, `'center'`, atau `'normal'`; nilai `null` akan mereset perataan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setHorizontalAlignments(alignments)`

Menetapkan petak persegi panjang perataan horizontal. lihat setHorizontalAlignment(alignment)

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

// The size of the two-dimensional array must match the size of the range.
var horizontalAlignments = [
  [ "left", "right", "center" ]
];

var range = sheet.getRange("B2:D2");
range.setHorizontalAlignments(horizontalAlignments);

Parameter

Nama	Type	Deskripsi
`alignments`	`Object[][]`	Array perataan dua dimensi, baik `'left'`, `'center'`, maupun `'normal'`; nilai `null` akan mereset perataan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

Lihat juga

setHorizontalAlignment(alignment)

`setNote(note)`

Menetapkan catatan ke nilai yang diberikan.

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

var cell = sheet.getRange("B2");
cell.setNote("This is a note");

Parameter

Nama	Type	Deskripsi
`note`	`String`	Nilai catatan yang ditetapkan untuk rentang; nilai `null` akan menghapus catatan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setNotes(notes)`

Menetapkan petak catatan persegi panjang (harus sesuai dengan dimensi rentang ini).

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

// The size of the two-dimensional array must match the size of the range.
var notes = [
  ["it goes", "like this", "the fourth, the fifth"],
  ["the minor fall", "and the", "major lift"]
];

var cell = sheet.getRange("B2:D3");
cell.setNotes(notes)

Parameter

Nama	Type	Deskripsi
`notes`	`Object[][]`	Array catatan dua dimensi; nilai `null` akan menghapus catatan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

Lihat juga

setNote(note)

`setNumberFormat(numberFormat)`

Menyetel format angka atau tanggal ke string pemformatan yang diberikan. Pola format yang diterima dijelaskan dalam dokumentasi Sheets API.

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

var cell = sheet.getRange("B2");
// Always show 3 decimal points
cell.setNumberFormat("0.000");

Parameter

Nama	Type	Deskripsi
`numberFormat`	`String`	String format angka.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setNumberFormats(numberFormats)`

Menetapkan petak persegi panjang format angka atau tanggal (harus sesuai dengan dimensi rentang ini). Nilai tersebut adalah string pola format seperti yang dijelaskan dalam dokumentasi Sheets API.

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

// The size of the two-dimensional array must match the size of the range.
var formats = [
  [ "0.000", "0,000,000", "$0.00" ]
];

var range = sheet.getRange("B2:D2");
range.setNumberFormats(formats);

Parameter

Nama	Type	Deskripsi
`numberFormats`	`Object[][]`	Array format dua dimensi untuk angka.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setRichTextValue(value)`

Menetapkan nilai Rich Text untuk sel dalam rentang.

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var richText = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
range.setRichTextValue(richText);

Parameter

Nama	Type	Deskripsi
`value`	`RichTextValue`	Nilai Rich Text yang diinginkan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setRichTextValues(values)`

Menetapkan petak persegi panjang nilai Rich Text.

// Sets the cells in range A1:A2 to have Rich Text values.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:A2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .build();
var richTextA1 = SpreadsheetApp.newRichTextValue()
    .setText("This cell is bold")
    .setTextStyle(bold)
    .build();
var richTextA2 = SpreadsheetApp.newRichTextValue()
    .setText("bold words, italic words")
    .setTextStyle(0, 11, bold)
    .setTextStyle(12, 24, italic)
    .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

Parameter

Nama	Type	Deskripsi
`values`	`RichTextValue[][]`	Nilai Rich Text yang diinginkan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setShowHyperlink(showHyperlink)`

Menetapkan apakah rentang harus menampilkan hyperlink atau tidak.

Parameter

Nama	Type	Deskripsi
`showHyperlink`	`Boolean`	Menunjukkan hyperlink atau tidak.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setTextDirection(direction)`

Menetapkan arah teks untuk sel dalam rentang. Jika arah yang ditentukan adalah null, arah akan ditentukan, lalu ditetapkan.

// Sets right-to-left text direction for the range.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parameter

Nama	Type	Deskripsi
`direction`	`TextDirection`	Arah teks yang diinginkan; jika `null`, arahnya akan ditentukan sebelum setelan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setTextDirections(directions)`

Menetapkan petak persegi panjang rute teks. Jika arah yang ditentukan adalah null, arah akan disimpulkan, lalu ditetapkan.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextDirections());

Parameter

Nama	Type	Deskripsi
`directions`	`TextDirection[][]`	Arah teks yang diinginkan; jika arah yang ditentukan adalah `null`, maka inferensi akan ditentukan sebelum setelan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setTextRotation(degrees)`

Menetapkan pengaturan rotasi teks untuk sel dalam rentang. Input sesuai dengan sudut antara orientasi teks standar dan orientasi yang diinginkan. Input nol menunjukkan bahwa teks ditetapkan ke orientasi standar.

Untuk arah teks kiri ke kanan, sudut positif berlawanan arah jarum jam, sedangkan untuk kanan ke kiri searah jarum jam.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setTextRotation(45);

Parameter

Nama	Type	Deskripsi
`degrees`	`Integer`	Sudut yang diinginkan antara orientasi standar dan orientasi yang diinginkan. Untuk teks kiri ke kanan, sudut positif berlawanan arah jarum jam.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setTextRotation(rotation)`

Menetapkan pengaturan rotasi teks untuk sel dalam rentang.

// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1.
var sheet = SpreadsheetApp.getActiveSheet();

var rotation = sheet.getRange("A1").getTextRotation();

sheet.getRange("B2:D4").setTextRotation(rotation);

Parameter

Nama	Type	Deskripsi
`rotation`	`TextRotation`	Pengaturan rotasi teks yang diinginkan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setTextRotations(rotations)`

Menetapkan petak rotasi teks persegi panjang.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextRotations());

Parameter

Nama	Type	Deskripsi
`rotations`	`TextRotation[][]`	Pengaturan rotasi teks yang diinginkan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setTextStyle(style)`

Menetapkan gaya teks untuk sel dalam rentang.

// Sets the cells in range C5:D6 to have underlined size 15 font.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("C5:D6");
var style = SpreadsheetApp.newTextStyle()
    .setFontSize(15)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

Parameter

Nama	Type	Deskripsi
`style`	`TextStyle`	Gaya teks yang diinginkan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setTextStyles(styles)`

Menetapkan petak persegi panjang gaya teks.

// Sets text styles for cells in range A1:B2
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var otherStyle = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .setUnderline(true)
    .setItalic(true)
    .setForegroundColor("#335522")
    .setFontSize(44)
    .build();
range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);

Parameter

Nama	Type	Deskripsi
`styles`	`TextStyle[][]`	Gaya teks yang diinginkan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setValue(value)`

Menetapkan nilai rentang. Nilainya dapat berupa angka, string, boolean, atau tanggal. Jika diawali dengan '=', file tersebut akan ditafsirkan sebagai formula.

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

var cell = sheet.getRange("B2");
cell.setValue(100);

Parameter

Nama	Type	Deskripsi
`value`	`Object`	Nilai untuk rentang tersebut.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setValues(values)`

Menetapkan petak nilai persegi panjang (harus cocok dengan dimensi rentang ini).

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

// The size of the two-dimensional array must match the size of the range.
var values = [
  [ "2.000", "1,000,000", "$2.99" ]
];

var range = sheet.getRange("B2:D2");
range.setValues(values);

Parameter

Nama	Type	Deskripsi
`values`	`Object[][]`	Array nilai dua dimensi.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setVerticalAlignment(alignment)`

Menetapkan perataan vertikal (atas ke bawah) untuk rentang yang ditentukan (atas/tengah/bawah).

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

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

Parameter

Nama	Type	Deskripsi
`alignment`	`String`	Perataan, baik `'top'`, `'middle'`, atau `'bottom'`; nilai `null` akan mereset perataan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setVerticalAlignments(alignments)`

Menetapkan petak persegi panjang perataan vertikal (harus cocok dengan dimensi rentang ini).

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

// The size of the two-dimensional array must match the size of the range.
var alignments = [
  [ "top", "middle", "bottom" ]
];

var range = sheet.getRange("B2:D2");
range.setVerticalAlignments(alignments);

Parameter

Nama	Type	Deskripsi
`alignments`	`Object[][]`	Array perataan dua dimensi, baik `'top'`, `'middle'` maupun `'bottom'`; nilai `null` akan mereset perataan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

Lihat juga

setVerticalAlignment(alignment)

`setVerticalText(isVertical)`

Menetapkan apakah teks akan ditumpuk untuk sel dalam rentang atau tidak. Jika teks ditumpuk secara vertikal, pengaturan rotasi teks derajat diabaikan.

// Sets all cell's in range B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setVerticalText(true);

Parameter

Nama	Type	Deskripsi
`isVertical`	`Boolean`	Apakah teks akan ditumpuk atau tidak.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setWrap(isWrapEnabled)`

Menetapkan penggabungan sel untuk rentang yang ditentukan.

Sel dengan ukuran penggabungan diaktifkan (default) untuk menampilkan konten lengkapnya. Sel dengan tampilan wrap sebanyak mungkin akan berada di dalam sel tanpa mengubah ukuran atau berjalan ke beberapa baris.

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

var cell = sheet.getRange("B2");
cell.setWrap(true);

Parameter

Nama	Type	Deskripsi
`isWrapEnabled`	`Boolean`	Apakah akan menggabungkan teks atau tidak.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setWrapStrategies(strategies)`

Menetapkan petak strategi wrap persegi panjang.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setWrapStrategies(range1.getWrapStrategies());

Parameter

Nama	Type	Deskripsi
`strategies`	`WrapStrategy[][]`	Strategi penggabungan yang diinginkan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setWrapStrategy(strategy)`

Menetapkan strategi pengemasan teks untuk sel dalam rentang.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parameter

Nama	Type	Deskripsi
`strategy`	`WrapStrategy`	Strategi penggabungan yang diinginkan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setWraps(isWrapEnabled)`

Menetapkan petak persegi panjang kebijakan penggabungan kata (harus cocok dengan dimensi rentang ini). Sel dengan pengubahan ukuran yang diaktifkan (default) untuk menampilkan konten lengkapnya. Sel dengan penggabungan yang dinonaktifkan ditampilkan sebanyak mungkin dalam sel tanpa mengubah ukuran atau berjalan ke beberapa baris.

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

// The size of the two-dimensional array must match the size of the range.
var wraps = [
  [ true, true, false ]
];

var range = sheet.getRange("B2:D2");
range.setWraps(wraps);

Parameter

Nama	Type	Deskripsi
`isWrapEnabled`	`Object[][]`	Array variabel menggabungkan yang terdiri dari dua dimensi yang menentukan apakah akan menggabungkan teks dalam sel atau tidak.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

Lihat juga

setWrap(isWrapEnabled)

`shiftColumnGroupDepth(delta)`

Mengubah kedalaman pengelompokan kolom dari rentang berdasarkan jumlah yang ditentukan.

Ini memiliki efek membuat, memodifikasi, atau menghapus grup yang berpotongan dengan rentang tersebut. Untuk delta positif, grup dibuat dan/atau dimodifikasi; untuk delta negatif, grup dihancurkan dan/atau dimodifikasi.

Hal ini tidak berpengaruh jika menurunkan kedalaman grup di bawah nol atau di atas delapan.

Jika column group control position adalah BEFORE, tindakan ini akan menampilkan error saat mencoba menggeser kedalaman baris pertama.

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

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

Parameter

Nama	Type	Deskripsi
`delta`	`Integer`	Jumlah yang digunakan untuk mengubah kedalaman grup kolom dari rentang ini.

Return

Range — Rentang ini, untuk perantaian.

Menampilkan

Error — saat mencoba menggeser kedalaman kolom pertama jika posisi kontrolnya adalah GroupControlTogglePosition.BEFORE

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`shiftRowGroupDepth(delta)`

Mengubah kedalaman pengelompokan baris dari rentang berdasarkan jumlah yang ditentukan.

Hal ini tidak berpengaruh jika menurunkan kedalaman grup di bawah nol atau di atas delapan.

Jika row group control position adalah BEFORE, ini akan menampilkan error saat mencoba menggeser kedalaman baris pertama.

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

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

Parameter

Nama	Type	Deskripsi
`delta`	`Integer`	Jumlah yang digunakan untuk mengubah kedalaman grup baris dari rentang ini.

Return

Range — Rentang ini, untuk perantaian.

Menampilkan

Error — saat mencoba mengalihkan kedalaman baris pertama saat posisi kontrol adalah GroupControlTogglePosition.BEFORE

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`sort(sortSpecObj)`

Mengurutkan sel dalam rentang yang diberikan, berdasarkan kolom dan urutan yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more readable
// code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);

Parameter

Nama	Type	Deskripsi
`sortSpecObj`	`Object`	Kolom yang akan diurutkan.

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`splitTextToColumns()`

Memisahkan kolom teks menjadi beberapa kolom berdasarkan pembatas yang terdeteksi otomatis.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns();

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`splitTextToColumns(delimiter)`

Memisahkan kolom teks menjadi beberapa kolom menggunakan string yang ditentukan sebagai pembatas kustom.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns('#');

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parameter

Nama	Type	Deskripsi
`delimiter`	`String`	Pembatas kustom untuk dipisahkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`splitTextToColumns(delimiter)`

Memisahkan kolom teks menjadi beberapa kolom berdasarkan pembatas yang ditentukan.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parameter

Nama	Type	Deskripsi
`delimiter`	`TextToColumnsDelimiter`	Pembatas preset untuk memisahkan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`trimWhitespace()`

Memangkas spasi kosong (seperti spasi, tab, atau baris baru) di setiap sel dalam rentang ini. Menghapus semua spasi kosong dari awal dan akhir teks setiap sel, serta mengurangi urutan karakter spasi kosong yang tersisa menjadi satu spasi.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)'])

range.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`uncheck()`

Mengubah status kotak centang dalam rentang menjadi “tidak dicentang”. Mengabaikan sel dalam rentang yang saat ini tidak berisi nilai yang dicentang atau tidak dicentang yang dikonfigurasi.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'unchecked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.uncheck();

Return

Range — Rentang ini, untuk perantaian.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

Metode yang tidak digunakan lagi

`getFontColor()`

Tidak digunakan lagi. Diganti dengan getFontColorObject()

Menampilkan warna font sel di sudut kiri atas rentang, dalam notasi CSS (seperti '#ffffff' atau 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontColor());

Return

String — Warna font dalam notasi CSS (seperti '#ffffff' atau 'white').

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getFontColors()`

Tidak digunakan lagi. Diganti dengan getFontColorObjects()

Menampilkan warna font sel dalam rentang dalam notasi CSS (seperti '#ffffff' atau 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontColors();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Return

String[][] — Array dua dimensi warna font yang terkait dengan sel dalam rentang.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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