Mengakses dan mengubah rentang spreadsheet. Rentang sel dapat berupa sel tunggal di {i>sheet<i} atau sekelompok sel yang berdekatan dalam suatu {i>sheet<i}.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
activate() | Range | Menetapkan rentang yang ditentukan sebagai active range , dengan bagian atas
sel kiri 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. |
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. |
applyColumnBanding() | Banding | Menerapkan tema garis berwarna kolom default ke rentang. |
applyColumnBanding(bandingTheme) | Banding | Menerapkan tema garis berwarna kolom yang ditentukan ke rentang. |
applyColumnBanding(bandingTheme, showHeader, showFooter) | Banding | Menerapkan tema garis banding kolom tertentu ke rentang dengan header dan footer yang ditentukan setelan. |
applyRowBanding() | Banding | Menerapkan tema baris garis default ke rentang. |
applyRowBanding(bandingTheme) | Banding | Menerapkan tema garis banding baris yang ditentukan ke rentang. |
applyRowBanding(bandingTheme, showHeader, showFooter) | Banding | Menerapkan tema garis bergaris 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 di sekitarnya dan secara otomatis mengisi rentang itu dengan nilai-nilai baru berdasarkan data yang ada di rentang itu. |
breakApart() | Range | Pisahkan sel multi-kolom dalam rentang menjadi sel individual 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 rentang konten, format, aturan validasi data, dan/atau komentar, seperti yang ditentukan dengan opsi lanjutan yang diberikan. |
clearContent() | Range | Menghapus konten rentang dan membiarkan pemformatan tetap utuh. |
clearDataValidations() | Range | Menghapus aturan validasi data untuk rentang tersebut. |
clearFormat() | Range | Menghapus pemformatan untuk rentang ini. |
clearNote() | Range | Mengosongkan catatan di sel atau beberapa sel yang ditentukan. |
collapseGroups() | Range | Menciutkan semua grup yang sepenuhnya tercakup dalam rentang. |
copyFormatToRange(gridId, column, columnEnd, row, rowEnd) | void | Salin format rentang ke lokasi yang ditentukan. |
copyFormatToRange(sheet, column, columnEnd, row, rowEnd) | void | Salin 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 | Salin konten rentang ke lokasi yang ditentukan. |
copyValuesToRange(sheet, column, columnEnd, row, rowEnd) | void | Salin konten rentang ke lokasi yang ditentukan. |
createDataSourcePivotTable(dataSource) | DataSourcePivotTable | Membuat tabel pivot sumber data kosong dari sumber data, yang ditambatkan di sel pertama dalam rentang ini. |
createDataSourceTable(dataSource) | DataSourceTable | Membuat tabel sumber data kosong dari sumber data, yang ditambatkan di sel pertama dalam {i>range<i}. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Menampilkan DeveloperMetadataFinderApi untuk menemukan metadata developer dalam cakupan {i>range<i}. |
createFilter() | Filter | Membuat filter dan menerapkannya ke rentang yang ditentukan pada sheet. |
createPivotTable(sourceData) | PivotTable | Membuat tabel pivot kosong dari sourceData yang ditentukan yang ditambatkan di sel pertama
dalam rentang ini. |
createTextFinder(findText) | TextFinder | Membuat pencari teks untuk rentang, yang dapat menemukan dan mengganti teks dalam rentang ini. |
deleteCells(shiftDimension) | void | Menghapus rentang sel ini. |
expandGroups() | Range | Luaskan 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 garis berwarna 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 Direction utama 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 rumus 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 data yang berpotongan dengan rentang. |
getDataSourceUrl() | String | Menampilkan URL untuk data dalam rentang ini, yang dapat digunakan untuk membuat diagram dan kueri. |
getDataTable() | DataTable | Menampilkan 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 sel kiri atas yang ditampilkan 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 di
pada lembar kerja. |
getFontColorObject() | Color | Menampilkan warna {i>font<i} 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 | Mengembalikan ukuran {i>font<i} dalam ukuran titik sel di sudut kiri atas rentang. |
getFontSizes() | Integer[][] | Menampilkan ukuran font sel dalam rentang. |
getFontStyle() | String | Menampilkan gaya font ('italic' atau 'normal' ) untuk sel di bagian kiri atas
sudut rentang. |
getFontStyles() | String[][] | Menampilkan gaya font sel dalam rentang. |
getFontWeight() | String | Mengembalikan ketebalan {i>font<i} (normal/tebal) untuk sel di sudut kiri atas rentang itu. |
getFontWeights() | String[][] | Menampilkan bobot font sel dalam rentang. |
getFormula() | String | Mengembalikan rumus (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 rumus (notasi A1) untuk sel dalam rentang. |
getFormulasR1C1() | String[][] | Menampilkan rumus (notasi R1C1) untuk sel dalam rentang. |
getGridId() | Integer | Menampilkan ID petak sheet induk rentang. |
getHeight() | Integer | Menampilkan tinggi rentang. |
getHorizontalAlignment() | String | Mengembalikan perataan horizontal teks (kiri/tengah/kanan) sel di kiri atas sudut 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 mewakili sel gabungan yang sepenuhnya
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, mengembalikan sel berikutnya yang ada di arah tertentu yang merupakan tepi rentang sel yang berdekatan dengan data di dalamnya atau sel di tepi {i>spreadsheet<i} ke arah itu. |
getNote() | String | Menampilkan catatan yang terkait dengan rentang yang diberikan. |
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 | Dapatkan format angka atau tanggal dari sel kiri atas dalam rentang yang ditentukan. |
getNumberFormats() | String[][] | Menampilkan format angka atau tanggal untuk sel dalam rentang. |
getRichTextValue() | RichTextValue | Menampilkan nilai Teks Kaya untuk sel kiri atas rentang, atau null jika sel
nilainya bukan teks. |
getRichTextValues() | RichTextValue[][] | Menampilkan nilai Rich Text untuk sel dalam rentang. |
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[][] | Mengembalikan 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. |
getValue() | Object | Menampilkan nilai sel kiri atas dalam rentang. |
getValues() | Object[][] | Menampilkan petak nilai persegi panjang untuk rentang ini. |
getVerticalAlignment() | String | Mengembalikan perataan vertikal (atas/tengah/bawah) sel di sudut kiri atas {i>range<i}. |
getVerticalAlignments() | String[][] | Menampilkan perataan vertikal sel dalam rentang. |
getWidth() | Integer | Menampilkan lebar rentang dalam kolom. |
getWrap() | Boolean | Menampilkan apakah teks dalam sel dibungkus. |
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 dibungkus. |
insertCells(shiftDimension) | Range | Menyisipkan sel kosong ke dalam rentang ini. |
insertCheckboxes() | Range | Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan true untuk dicentang dan
false untuk tidak dicentang. |
insertCheckboxes(checkedValue) | Range | Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan nilai khusus untuk kotak centang dan {i>string<i} kosong untuk tidak dicentang. |
insertCheckboxes(checkedValue, uncheckedValue) | Range | Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan nilai khusus untuk kotak yang dicentang dan status tidak dicentang. |
isBlank() | Boolean | Menampilkan true jika rentang benar-benar kosong. |
isChecked() | Boolean | Mengembalikan 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 yang digabungkan. |
isStartColumnBounded() | Boolean | Menentukan apakah awal rentang terikat ke kolom tertentu. |
isStartRowBounded() | Boolean | Menentukan apakah awal rentang terikat pada baris tertentu. |
merge() | Range | Menggabungkan sel dalam rentang bersama menjadi satu blok. |
mergeAcross() | Range | Gabungkan sel-sel dalam rentang di seluruh kolom rentang tersebut. |
mergeVertically() | Range | Menggabungkan sel-sel dalam rentang bersama-sama. |
moveTo(target) | void | Potong dan tempel (baik format maupun nilai) dari rentang ini ke rentang target. |
offset(rowOffset, columnOffset) | Range | Menampilkan rentang baru yang di-offset dari rentang ini berdasarkan jumlah baris dan kolom yang ditentukan (yang bisa bernilai negatif). |
offset(rowOffset, columnOffset, numRows) | Range | Mengembalikan rentang baru yang relatif terhadap rentang saat ini, yang titik kiri atasnya di-offset dari rentang saat ini dengan baris dan kolom tertentu, dan dengan ketinggian yang ditentukan dalam sel. |
offset(rowOffset, columnOffset, numRows, numColumns) | Range | Mengembalikan rentang baru yang relatif terhadap rentang saat ini, yang titik kiri atasnya di-offset dari rentang saat ini dengan baris dan kolom yang diberikan, dan dengan tinggi dan lebar yang ditentukan sel. |
protect() | Protection | Membuat objek yang dapat melindungi rentang agar tidak diedit kecuali oleh pengguna yang memiliki izin akses. |
randomize() | Range | Mengacak urutan baris dalam rentang yang ditentukan. |
removeCheckboxes() | Range | Menghapus semua kotak centang dari rentang. |
removeDuplicates() | Range | Menghapus baris dalam rentang ini yang berisi nilai yang merupakan duplikat nilai di baris sebelumnya. |
removeDuplicates(columnsToCompare) | Range | Menghapus baris dalam rentang ini yang berisi nilai di kolom tertentu yang merupakan duplikat nilai di 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 sesuai dengan dimensi rentang ini). |
setBackgroundRGB(red, green, blue) | Range | Menyetel latar belakang ke warna yang diberikan menggunakan nilai RGB (bilangan bulat antara 0 dan 255 inklusif). |
setBackgrounds(color) | Range | Menetapkan petak persegi panjang warna latar belakang (harus sesuai 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 rentang yang ditentukan. |
setFontColorObjects(colors) | Range | Menetapkan petak warna font persegi panjang (harus sesuai dengan dimensi rentang ini). |
setFontColors(colors) | Range | Menetapkan petak warna font persegi panjang (harus sesuai 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 "Documents" atau "Helvetica". |
setFontLine(fontLine) | Range | Menetapkan gaya garis font rentang yang ditentukan ('underline' , 'line-through' , atau
'none' ). |
setFontLines(fontLines) | Range | Menetapkan petak gaya garis persegi panjang (harus cocok dengan dimensi rentang ini). |
setFontSize(size) | Range | Menetapkan ukuran font, dengan ukuran menjadi ukuran titik yang akan digunakan. |
setFontSizes(sizes) | Range | Menetapkan petak ukuran font persegi panjang (harus sesuai dengan dimensi rentang ini). |
setFontStyle(fontStyle) | Range | Menetapkan gaya font untuk rentang yang ditentukan ('italic' atau 'normal' ). |
setFontStyles(fontStyles) | Range | Menetapkan petak gaya font persegi panjang (harus sesuai dengan dimensi rentang ini). |
setFontWeight(fontWeight) | Range | Menetapkan ketebalan font untuk rentang yang ditentukan (normal/tebal). |
setFontWeights(fontWeights) | Range | Menetapkan petak persegi panjang untuk bobot font (harus sesuai 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 formula persegi panjang (harus cocok dengan dimensi rentang ini). |
setFormulasR1C1(formulas) | Range | Menetapkan petak formula persegi panjang (harus cocok dengan dimensi rentang ini). |
setHorizontalAlignment(alignment) | Range | Tetapkan perataan horizontal (kiri ke kanan) untuk rentang yang ditentukan (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 | Menetapkan format angka atau tanggal ke string pemformatan yang diberikan. |
setNumberFormats(numberFormats) | Range | Menetapkan petak persegi panjang untuk format angka atau tanggal (harus cocok 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 akan menampilkan hyperlink atau tidak. |
setTextDirection(direction) | Range | Menetapkan arah teks untuk sel dalam rentang. |
setTextDirections(directions) | Range | Menetapkan petak persegi panjang untuk arah teks. |
setTextRotation(degrees) | Range | Menetapkan setelan rotasi teks untuk sel dalam rentang. |
setTextRotation(rotation) | Range | Menetapkan setelan 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 gaya teks persegi panjang. |
setValue(value) | Range | Menetapkan nilai rentang. |
setValues(values) | Range | Menetapkan petak nilai persegi panjang (harus sesuai dengan dimensi rentang ini). |
setVerticalAlignment(alignment) | Range | Setel perataan vertikal (atas ke bawah) untuk rentang yang diberikan (atas/tengah/bawah). |
setVerticalAlignments(alignments) | Range | Menetapkan petak persegi panjang garis vertikal (harus sesuai dengan dimensi rentang ini). |
setVerticalText(isVertical) | Range | Menetapkan apakah akan menumpuk teks untuk sel dalam rentang atau tidak. |
setWrap(isWrapEnabled) | Range | Menetapkan gabungan sel dari rentang yang ditentukan. |
setWrapStrategies(strategies) | Range | Menetapkan strategi penggabungan 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 berdasarkan jumlah yang ditentukan. |
shiftRowGroupDepth(delta) | Range | Mengubah kedalaman pengelompokan baris dalam 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 secara otomatis. |
splitTextToColumns(delimiter) | void | Memisahkan kolom teks menjadi beberapa kolom menggunakan string yang ditentukan sebagai pemisah 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”. |
Dokumentasi mendetail
activate()
Menetapkan rentang yang ditentukan sebagai active range
, dengan bagian atas
sel kiri 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();
Pulang pergi
Range
— Rentang ini, untuk perantaian.
activateAsCurrentCell()
Menetapkan sel yang ditentukan sebagai current cell
.
Jika sel yang ditentukan ada dalam rentang yang sudah ada, rentang tersebut akan menjadi aktif rentang dengan sel sebagai sel yang sedang digunakan.
Jika sel yang ditentukan tidak ada dalam rentang yang ada, maka pilihan yang ada akan dihapus dan sel menjadi sel saat ini dan rentang aktif.
Catatan: Range
yang ditentukan harus terdiri dari satu sel, jika tidak, akan muncul
pengecualian.
// 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());
Pulang pergi
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 | Jenis | Deskripsi |
---|---|---|
key | String | Kunci untuk metadata developer baru. |
Pulang pergi
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.
// 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 | Jenis | Deskripsi |
---|---|---|
key | String | Kunci untuk metadata developer baru. |
visibility | DeveloperMetadataVisibility | Visibilitas metadata developer baru. |
Pulang pergi
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 of Sheet1. 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 | Jenis | Deskripsi |
---|---|---|
key | String | Kunci untuk metadata developer baru. |
value | String | Nilai untuk metadata developer baru. |
Pulang pergi
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.
// 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 | Jenis | Deskripsi |
---|---|---|
key | String | Kunci untuk metadata developer baru. |
value | String | Nilai untuk metadata developer baru. |
visibility | DeveloperMetadataVisibility | Visibilitas metadata developer baru. |
Pulang pergi
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 garis berwarna kolom default ke rentang. Secara default, garis berwarna memiliki header dan tidak warna {i>footer<i}.
// 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());
Pulang pergi
Banding
— Satu 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 garis berwarna kolom yang ditentukan ke rentang. Secara default, garis berwarna memiliki header dan tanpa warna {i>footer<i}.
// 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 | Jenis | Deskripsi |
---|---|---|
bandingTheme | BandingTheme | Tema warna yang akan diterapkan ke kolom dalam rentang. |
Pulang pergi
Banding
— Satu 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 garis banding kolom tertentu ke rentang dengan header dan footer yang ditentukan setelan.
// 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 | Jenis | Deskripsi |
---|---|---|
bandingTheme | BandingTheme | Tema warna yang akan diterapkan ke kolom dalam rentang. |
showHeader | Boolean | Jika true , warna header tema garis berwarna akan diterapkan ke warna
. |
showFooter | Boolean | Jika true , warna footer tema garis berwarna diterapkan ke warna terakhir
. |
Pulang pergi
Banding
— Satu 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 baris garis default ke rentang. Secara default, garis berwarna memiliki header dan tidak warna {i>footer<i}.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies row banding to rows 1-30. range.applyRowBanding(); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0] .getSecondRowColorObject() .asRgbColor() .asHexString(); // Logs the hex color to console. console.log(secondRowColor);
Pulang pergi
Banding
— Garis berwarna.
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 garis banding baris yang ditentukan ke rentang. Secara default, garis berwarna memiliki header dan tidak warna {i>footer<i}.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding theme to rows 1-30. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0] .getSecondRowColorObject() .asRgbColor() .asHexString(); // Logs the hex color to console. console.log(secondRowColor);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
bandingTheme | BandingTheme | Tema warna yang akan diterapkan ke baris dalam rentang. |
Pulang pergi
Banding
— Satu 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 garis banding baris tertentu ke rentang dengan setelan header dan footer yang ditentukan.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding to rows 1-30 and // specifies to hide the header and show the footer. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
bandingTheme | BandingTheme | Tema warna yang akan diterapkan ke baris dalam rentang. |
showHeader | Boolean | Jika true , warna header tema garis berwarna diterapkan ke baris pertama. |
showFooter | Boolean | Jika true , warna footer tema garis berwarna diterapkan ke baris terakhir. |
Pulang pergi
Banding
— Satu 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-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 angka yang meningkat 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 | Jenis | Deskripsi |
---|---|---|
destination | Range | Rentang yang akan diisi secara otomatis dengan nilai. Rentang tujuan harus memuat rentang ini dan memperluasnya hanya ke satu arah (ke atas, bawah, kiri, atau kanan). |
series | AutoFillSeries | Jenis deret isi otomatis yang harus digunakan untuk menghitung nilai baru. Tujuan efek rangkaian ini berbeda 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 di sekitarnya dan secara otomatis mengisi
rentang itu dengan nilai-nilai baru
berdasarkan data yang ada di rentang itu. Nilai-nilai baru ini juga
ditentukan oleh jenis series
yang ditentukan.
Rentang tujuan yang dihitung mempertimbangkan data di sekitarnya untuk menentukan lokasi nilai harus dimasukkan: jika ada data di sebelah kiri atau kanan kolom yang diisi 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-nilai baru
ini “melekat” ke sel-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 | Jenis | Deskripsi |
---|---|---|
series | AutoFillSeries | Jenis deret isi otomatis yang harus digunakan untuk menghitung nilai baru. Tujuan efek rangkaian ini berbeda 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 individual lagi.
Memanggil fungsi ini pada rentang sama dengan memilih rentang dan mengklik Format > Gabungkan sel > Pisahkan.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6 on Sheet1. const range = sheet.getRange('A1:C6'); // Unmerges the range A1:C6 into individual cells. range.breakApart();
Pulang pergi
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. {i>Spreadsheet<i} pemilik selalu dapat mengedit rentang dan sheet dilindungi.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6 on Sheet1. const range = sheet.getRange('A1:C6'); // Logs whether the user has permission to edit every cell in the range. console.log(range.canEdit());
Pulang pergi
Boolean
— true
jika pengguna memiliki izin untuk mengedit setiap sel dalam rentang; false
sebaliknya.
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 telah 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();
Pulang pergi
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 berbagai konten dan format.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clear();
Pulang pergi
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 rentang konten, format, aturan validasi data, dan/atau komentar, seperti yang ditentukan dengan opsi lanjutan yang diberikan. Secara default, semua data dihapus.
// The code below clears range C2:G7 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 | Jenis | Deskripsi |
---|---|---|
options | Object | Objek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini. |
Parameter lanjutan
Nama | Jenis | Deskripsi |
---|---|---|
commentsOnly | Boolean | Apakah hanya menghapus komentar. |
contentsOnly | Boolean | Apakah akan menghapus konten saja. |
formatOnly | Boolean | Apakah akan menghapus format saja; perhatikan bahwa menghapus format ini juga menghapus aturan validasi data. |
validationsOnly | Boolean | Apakah akan menghapus hanya aturan validasi data. |
skipFilteredRows | Boolean | Apakah ingin menghindari penghapusan baris yang difilter. |
Pulang pergi
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 dan membiarkan pemformatan tetap utuh.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearContent();
Pulang pergi
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();
Pulang pergi
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.
Ini akan menghapus pemformatan teks untuk sel atau sel dalam rentang, tetapi tidak mengatur ulang aturan pemformatan angka.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearFormat();
Pulang pergi
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()
Mengosongkan catatan di sel atau beberapa sel yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearNote();
Pulang pergi
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()
Menciutkan semua grup yang sepenuhnya tercakup dalam rentang. Jika tidak ada grup yang sepenuhnya dalam rentang, grup diperluas terdalam yang sebagian berada dalam rentang diciutkan.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are collapsed. range.collapseGroups();
Pulang pergi
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)
Salin format rentang ke lokasi yang ditentukan. Jika tujuan lebih besar atau lebih kecil daripada rentang sumber, maka sumber akan diulangi atau dipotong sesuai dengan itu. Perhatikan bahwa akan menyalin pemformatan saja.
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 | Jenis | Deskripsi |
---|---|---|
gridId | Integer | ID unik sheet dalam spreadsheet, terlepas dari posisi. |
column | Integer | Kolom pertama rentang target. |
columnEnd | Integer | Kolom akhir 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
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)
Salin format rentang ke lokasi yang ditentukan. Jika tujuan lebih besar atau lebih kecil daripada rentang sumber, maka sumber akan diulangi atau dipotong sesuai dengan itu. Perhatikan bahwa akan menyalin pemformatan saja.
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 | Jenis | Deskripsi |
---|---|---|
sheet | Sheet | Sheet target. |
column | Integer | Kolom pertama rentang target. |
columnEnd | Integer | Kolom akhir 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 pemformatan akan 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 | Jenis | Deskripsi |
---|---|---|
destination | Range | Rentang tujuan untuk menyalin; 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 | Jenis | Deskripsi |
---|---|---|
destination | Range | Rentang tujuan untuk menyalin; hanya posisi sel di kiri atas yang relevan. |
copyPasteType | CopyPasteType | Jenis yang menentukan cara isi rentang ditempelkan ke tujuan. |
transposed | Boolean | Apakah rentang harus ditempelkan pada orientasi yang ditransposisikan. |
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 {i>default<i} dan pemformatan disalin, tetapi Anda dapat menggantinya 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 | Jenis | Deskripsi |
---|---|---|
destination | Range | Rentang tujuan untuk menyalin; 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 | Jenis | Deskripsi |
---|---|---|
formatOnly | Boolean | menetapkan bahwa hanya format yang boleh disalin |
contentsOnly | Boolean | menetapkan bahwa hanya konten yang boleh 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)
Salin konten rentang ke lokasi yang ditentukan. Jika tujuan lebih besar atau lebih kecil daripada rentang sumber, maka sumber akan diulangi atau dipotong sesuai dengan itu.
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 | Jenis | Deskripsi |
---|---|---|
gridId | Integer | ID unik sheet dalam spreadsheet, terlepas dari posisi. |
column | Integer | Kolom pertama rentang target. |
columnEnd | Integer | Kolom akhir 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
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)
Salin konten rentang ke lokasi yang ditentukan. Jika tujuan lebih besar atau lebih kecil daripada rentang sumber, maka sumber akan diulangi atau dipotong sesuai dengan itu.
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 | Jenis | Deskripsi |
---|---|---|
sheet | Sheet | Sheet target. |
column | Integer | Kolom pertama rentang target. |
columnEnd | Integer | Kolom akhir 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 di 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 | Jenis | Deskripsi |
---|---|---|
dataSource | DataSource | Sumber data untuk membuat tabel pivot. |
Pulang pergi
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 di sel pertama dalam {i>range<i}.
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 | Jenis | Deskripsi |
---|---|---|
dataSource | DataSource | Sumber data untuk membuat tabel pivot. |
Pulang pergi
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 {i>range<i}. Metadata berada dalam cakupan rentang itu, hanya jika metadata tersebut sepenuhnya terkandung dalam {i>range<i}. Misalnya, metadata yang dikaitkan dengan baris '3:3' tidak berada dalam cakupan rentang ‘A1:D5’ tetapi berada dalam cakupan rentang ‘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());
Pulang pergi
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
sebuah {i>sheet<i}. 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); }
Grid
sheet, jenis default sheet.
Lembar kisi adalah lembar yang tidak terhubung ke {i>database<i}. Untuk membuat jenis filter lain,
lihat referensi berikut:
- Membuat 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)
Pulang pergi
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 yang ditambatkan di 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 | Jenis | Deskripsi |
---|---|---|
sourceData | Range | Data yang menjadi asal pembuatan tabel pivot. |
Pulang pergi
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 dalam 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 = textFinder.replaceWith('cat');
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
findText | String | Teks yang akan ditelusuri. |
Pulang pergi
TextFinder
— TextFinder
untuk rentang
deleteCells(shiftDimension)
Menghapus rentang sel ini. Data yang ada dalam sheet di sepanjang dimensi yang disediakan akan digeser menuju 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 | Jenis | 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()
Luaskan grup yang diciutkan yang rentang atau tombol kontrolnya berpotongan dengan rentang ini. Tujuan lokasi tombol alih kontrol adalah indeks tempat tombol kontrol ditampilkan, langsung sebelum atau setelah grup tergantung pada pengaturan. Jika ada lebih dari satu kelompok di lokasi yang sama, kelompok dangkal dan diperbesar.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are expanded. range.expandGroups();
Pulang pergi
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());
Pulang pergi
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());
Pulang pergi
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());
Pulang pergi
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()); } }
Pulang pergi
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]); } }
Pulang pergi
String[][]
— Array dua dimensi dari kode warna dari 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 garis berwarna 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()); }
Pulang pergi
Banding[]
— Semua garis berwarna 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 | Jenis | Deskripsi |
---|---|---|
row | Integer | Baris sel relatif terhadap rentang. |
column | Integer | Kolom sel relatif terhadap rentang. |
Pulang pergi
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());
Pulang pergi
Integer
— Posisi kolom awal rentang di 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 Direction
utama untuk mencakup semua
sel yang berdekatan
dengan data di dalamnya. Jika rentang dikelilingi oleh sel kosong yang tidak termasuk yang
di sepanjang diagonal, rentang itu sendiri dikembalikan. 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());
Pulang pergi
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
didasarkan pada deteksi data di samping rentang yang diatur seperti tabel. Rentang yang diperluas
mencakup semua sel yang berdekatan dengan data di dalamnya sepanjang dimensi yang ditentukan termasuk tabel
batasan data. Jika rentang asli dikelilingi oleh sel kosong di sepanjang dimensi yang ditentukan,
maka rentang itu sendiri
akan dikembalikan. 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 | Jenis | Deskripsi |
---|---|---|
dimension | Dimension | Dimensi yang akan diperluas rentangnya. |
Pulang pergi
Range
— Region data atau rentang rentang yang mencakup setiap kolom atau setiap baris yang dibentangkan 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 rumus sumber data.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1 on Sheet1. const range = sheet.getRange('A1'); // Gets the data source formula from cell A1. const dataSourceFormula = range.getDataSourceFormula(); // Gets the formula. const formula = dataSourceFormula.getFormula(); // Logs the formula. console.log(formula);
Pulang pergi
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.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B5 on Sheet1. const range = sheet.getRange('A1:B5'); // Gets an array of the data source formulas in the range A1:B5. const dataSourceFormulas = range.getDataSourceFormulas(); // Logs the first formula in the array. console.log(dataSourceFormulas[0].getFormula());
Pulang pergi
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.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets an array of the data source pivot tables in the range A1:G50. const dataSourcePivotTables = range.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
Pulang pergi
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 data yang berpotongan dengan rentang.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets the first data source table in the range A1:G50. const dataSourceTable = range.getDataSourceTables()[0]; // Logs the time of the last completed data execution on the data source table. console.log(dataSourceTable.getStatus().getLastExecutionTime());
Pulang pergi
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(); }
piechart.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>
Pulang pergi
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()
Menampilkan data di dalam objek ini sebagai DataTable.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B7 on Sheet1. const range = sheet.getRange('A1:B7'); // Gets the range A1:B7 as a data table. The values in each column must be of the same type. const datatable = range.getDataTable(); // Uses the Charts service to build a bar chart from the data table. // This doesn't build an embedded chart. To do that, use sheet.newChart().addRange() instead. const chart = Charts.newBarChart() .setDataTable(datatable) .setOption('title', 'Your Chart Title Here') .build();
Pulang pergi
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 | Jenis | Deskripsi |
---|---|---|
firstRowIsHeader | Boolean | Apakah akan memperlakukan baris pertama sebagai header. |
Pulang pergi
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
telah 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.') }
Pulang pergi
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);
Pulang pergi
DataValidation[][]
— Array dua dimensi aturan validasi data yang terkait dengan sel dalam
{i>range<i}.
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.
// 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 metadata to row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Logs the metadata to console. for (const metadata of range.getDeveloperMetadata()) { console.log(`${metadata.getKey()}: ${metadata.getValue()}`); }
Pulang pergi
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 sel kiri atas yang ditampilkan dalam rentang. Nilainya adalah String
.
Nilai yang ditampilkan memperhitungkan format tanggal, waktu, dan mata uang, termasuk
format yang diterapkan secara otomatis oleh setelan lokal spreadsheet. Sel kosong menampilkan nilai kosong
{i>string<i}.
// 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 A30 and sets its value to 'Test code.' const cell = sheet.getRange('A30'); cell.setValue('Test code'); // Gets the value and logs it to the console. console.log(cell.getDisplayValue());
Pulang pergi
String
— Nilai yang ditampilkan 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
getDisplayValues()
Menampilkan petak nilai persegi panjang untuk rentang ini.
Menampilkan array dua dimensi dari nilai yang ditampilkan, diindeks menurut baris, lalu menurut kolom. Tujuan
nilainya adalah objek String
. Nilai yang ditampilkan memperhitungkan
tanggal, waktu, dan
pemformatan mata uang, termasuk format yang diterapkan secara otomatis oleh lokal spreadsheet
deskripsi tempat. Sel kosong diwakili oleh string kosong dalam array. Ingatlah bahwa meskipun
indeks rentang dimulai dari 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]);
Pulang pergi
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 di
pada lembar kerja.
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();
Pulang pergi
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 {i>font<i} 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());
Pulang pergi
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()); } }
Pulang pergi
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]); } }
Pulang pergi
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());
Pulang pergi
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());
Pulang pergi
String
— Baris 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]); } }
Pulang pergi
String[][]
— Array dua dimensi dari garis font yang dikaitkan 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
getFontSize()
Mengembalikan ukuran {i>font<i} dalam ukuran titik sel di sudut kiri atas rentang.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"