Class Sheet

Sheet

Mengakses dan mengubah sheet spreadsheet. Operasi yang umum adalah mengganti nama sheet dan mengakses objek rentang dari sheet.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
activate()SheetMengaktifkan sheet ini.
addDeveloperMetadata(key)SheetMenambahkan metadata developer dengan kunci yang ditentukan ke sheet.
addDeveloperMetadata(key, visibility)SheetMenambahkan metadata developer dengan kunci dan visibilitas yang ditentukan ke sheet.
addDeveloperMetadata(key, value)SheetMenambahkan metadata developer dengan kunci dan nilai yang ditentukan ke sheet.
addDeveloperMetadata(key, value, visibility)SheetMenambahkan metadata developer dengan kunci, nilai, dan visibilitas yang ditentukan ke sheet.
appendRow(rowContents)SheetMenambahkan baris ke bagian bawah region data saat ini dalam sheet.
asDataSourceSheet()DataSourceSheetMenampilkan sheet sebagai DataSourceSheet jika sheet berjenis SheetType.DATASOURCE, atau null jika tidak.
autoResizeColumn(columnPosition)SheetMenetapkan lebar kolom tertentu agar sesuai dengan kontennya.
autoResizeColumns(startColumn, numColumns)SheetMenetapkan lebar semua kolom yang dimulai pada posisi kolom tertentu agar sesuai dengan kontennya.
autoResizeRows(startRow, numRows)SheetMenetapkan tinggi semua baris yang dimulai dari posisi baris yang ditentukan agar sesuai dengan kontennya.
clear()SheetMenghapus sheet konten dan informasi format.
clear(options)SheetMenghapus sheet konten dan/atau format, seperti yang ditentukan dengan opsi lanjutan yang diberikan.
clearConditionalFormatRules()voidMenghapus semua aturan format bersyarat dari sheet.
clearContents()SheetMenghapus sheet konten, sekaligus mempertahankan informasi format.
clearFormats()SheetMenghapus sheet pemformatan, sambil mempertahankan kontennya.
clearNotes()SheetMenghapus sheet dari semua catatan.
collapseAllColumnGroups()SheetMenciutkan semua grup kolom pada sheet.
collapseAllRowGroups()SheetMenciutkan semua grup baris pada sheet.
copyTo(spreadsheet)SheetMenyalin sheet ke spreadsheet tertentu, yang dapat berupa spreadsheet yang sama sebagai sumber.
createDeveloperMetadataFinder()DeveloperMetadataFinderMenampilkan DeveloperMetadataFinder untuk menemukan metadata developer dalam cakupan sheet ini.
createTextFinder(findText)TextFinderMembuat pencari teks untuk sheet, yang dapat mencari dan mengganti teks dalam sheet.
deleteColumn(columnPosition)SheetMenghapus kolom di posisi kolom tertentu.
deleteColumns(columnPosition, howMany)voidMenghapus sejumlah kolom yang dimulai pada posisi kolom tertentu.
deleteRow(rowPosition)SheetMenghapus baris di posisi baris tertentu.
deleteRows(rowPosition, howMany)voidMenghapus sejumlah baris yang dimulai pada posisi baris yang ditentukan.
expandAllColumnGroups()SheetMeluaskan semua grup kolom di sheet.
expandAllRowGroups()SheetMeluaskan semua grup baris pada sheet.
expandColumnGroupsUpToDepth(groupDepth)SheetMemperluas semua grup kolom hingga kedalaman yang ditentukan dan menciutkan semua grup kolom lainnya.
expandRowGroupsUpToDepth(groupDepth)SheetMeluaskan semua grup baris hingga kedalaman yang ditentukan dan menciutkan semua grup baris lainnya.
getActiveCell()RangeMenampilkan sel aktif dalam sheet ini.
getActiveRange()RangeMenampilkan rentang yang dipilih di sheet aktif, atau null jika tidak ada rentang aktif.
getActiveRangeList()RangeListMenampilkan daftar rentang aktif dalam sheet aktif atau null jika tidak ada rentang aktif.
getBandings()Banding[]Menampilkan semua garis berwarna dalam sheet ini.
getCharts()EmbeddedChart[]Menampilkan array diagram pada sheet ini.
getColumnGroup(columnIndex, groupDepth)GroupMenampilkan grup kolom pada indeks dan kedalaman grup yang ditentukan.
getColumnGroupControlPosition()GroupControlTogglePositionMenampilkan GroupControlTogglePosition untuk semua grup kolom pada sheet.
getColumnGroupDepth(columnIndex)IntegerMenampilkan kedalaman grup kolom pada indeks yang diberikan.
getColumnWidth(columnPosition)IntegerMendapatkan lebar kolom yang ditentukan dalam piksel.
getConditionalFormatRules()ConditionalFormatRule[]Dapatkan semua aturan format bersyarat dalam sheet ini.
getCurrentCell()RangeMenampilkan sel saat ini dalam sheet aktif atau null jika tidak ada sel saat ini.
getDataRange()RangeMenampilkan Range yang sesuai dengan dimensi yang berisi data.
getDataSourceFormulas()DataSourceFormula[]Mendapatkan semua formula sumber data.
getDataSourcePivotTables()DataSourcePivotTable[]Mendapatkan semua tabel pivot sumber data.
getDataSourceTables()DataSourceTable[]Mendapatkan semua tabel sumber data.
getDeveloperMetadata()DeveloperMetadata[]Dapatkan semua metadata developer yang terkait dengan sheet ini.
getDrawings()Drawing[]Menampilkan array gambar pada sheet.
getFilter()FilterMenampilkan filter dalam sheet ini, atau null jika tidak ada filter.
getFormUrl()StringMenampilkan URL untuk formulir yang mengirim responsnya ke sheet ini, atau null jika sheet ini tidak memiliki formulir terkait.
getFrozenColumns()IntegerMenampilkan jumlah kolom yang dibekukan.
getFrozenRows()IntegerMenampilkan jumlah baris yang dibekukan.
getImages()OverGridImage[]Menampilkan semua gambar di petak pada sheet.
getIndex()IntegerMendapatkan posisi sheet di spreadsheet induknya.
getLastColumn()IntegerMenampilkan posisi kolom terakhir yang memiliki konten.
getLastRow()IntegerMenampilkan posisi baris terakhir yang memiliki konten.
getMaxColumns()IntegerMenampilkan jumlah kolom saat ini dalam sheet, apa pun kontennya.
getMaxRows()IntegerMenampilkan jumlah baris saat ini dalam sheet, apa pun kontennya.
getName()StringMenampilkan nama sheet.
getNamedRanges()NamedRange[]Mendapatkan semua rentang bernama dalam sheet ini.
getParent()SpreadsheetMenampilkan Spreadsheet yang berisi sheet ini.
getPivotTables()PivotTable[]Menampilkan semua tabel pivot pada sheet ini.
getProtections(type)Protection[]Mendapatkan array objek yang mewakili semua rentang dilindungi dalam sheet, atau array elemen tunggal yang mewakili perlindungan pada sheet itu sendiri.
getRange(row, column)RangeMenampilkan rentang dengan sel kiri atas pada koordinat yang diberikan.
getRange(row, column, numRows)RangeMenampilkan rentang dengan sel kiri atas pada koordinat yang ditentukan, dan dengan jumlah baris yang ditentukan.
getRange(row, column, numRows, numColumns)RangeMenampilkan rentang dengan sel kiri atas pada koordinat yang ditentukan dengan jumlah baris dan kolom yang ditentukan.
getRange(a1Notation)RangeMenampilkan rentang seperti yang ditentukan dalam notasi A1 atau notasi R1C1.
getRangeList(a1Notations)RangeListMenampilkan koleksi RangeList yang merepresentasikan rentang dalam sheet yang sama yang ditentukan oleh daftar notasi A1 atau notasi R1C1 yang tidak kosong.
getRowGroup(rowIndex, groupDepth)GroupMenampilkan grup baris pada indeks dan kedalaman grup yang ditentukan.
getRowGroupControlPosition()GroupControlTogglePositionMenampilkan GroupControlTogglePosition untuk semua grup baris pada sheet.
getRowGroupDepth(rowIndex)IntegerMenampilkan kedalaman grup baris pada indeks yang diberikan.
getRowHeight(rowPosition)IntegerMendapatkan tinggi baris yang ditentukan dalam piksel.
getSelection()SelectionMenampilkan Selection saat ini di spreadsheet.
getSheetId()IntegerMenampilkan ID sheet yang direpresentasikan oleh objek ini.
getSheetName()StringMenampilkan nama sheet.
getSheetValues(startRow, startColumn, numRows, numColumns)Object[][]Menampilkan nilai kisi persegi panjang untuk rentang ini mulai dari koordinat yang diberikan.
getSlicers()Slicer[]Menampilkan array pemotong pada sheet.
getTabColorObject()ColorMendapatkan warna tab sheet, atau null jika tab sheet tidak memiliki warna.
getType()SheetTypeMenampilkan jenis sheet.
hasHiddenGridlines()BooleanMenampilkan true jika garis petak sheet disembunyikan; jika tidak, menampilkan false.
hideColumn(column)voidMenyembunyikan satu atau beberapa kolom dalam rentang yang diberikan.
hideColumns(columnIndex)voidMenyembunyikan satu kolom pada indeks yang diberikan.
hideColumns(columnIndex, numColumns)voidMenyembunyikan satu atau beberapa kolom berturut-turut yang dimulai pada indeks yang diberikan.
hideRow(row)voidMenyembunyikan baris dalam rentang yang diberikan.
hideRows(rowIndex)voidMenyembunyikan baris pada indeks yang ditentukan.
hideRows(rowIndex, numRows)voidMenyembunyikan satu atau beberapa baris berturut-turut yang dimulai pada indeks yang ditentukan.
hideSheet()SheetMenyembunyikan sheet ini.
insertChart(chart)voidMenambahkan diagram baru ke sheet ini.
insertColumnAfter(afterPosition)SheetMenyisipkan kolom setelah posisi kolom yang ditentukan.
insertColumnBefore(beforePosition)SheetMenyisipkan kolom sebelum posisi kolom yang ditentukan.
insertColumns(columnIndex)voidMenyisipkan kolom kosong dalam sheet di lokasi yang ditentukan.
insertColumns(columnIndex, numColumns)voidMenyisipkan satu atau beberapa kolom kosong berturut-turut dalam sheet yang dimulai pada lokasi yang ditentukan.
insertColumnsAfter(afterPosition, howMany)SheetMenyisipkan jumlah kolom tertentu setelah posisi kolom yang ditentukan.
insertColumnsBefore(beforePosition, howMany)SheetMenyisipkan jumlah kolom sebelum posisi kolom tertentu.
insertImage(blobSource, column, row)OverGridImageMenyisipkan BlobSource sebagai gambar dalam dokumen pada baris dan kolom tertentu.
insertImage(blobSource, column, row, offsetX, offsetY)OverGridImageMenyisipkan BlobSource sebagai gambar dalam dokumen pada baris dan kolom tertentu, dengan offset piksel.
insertImage(url, column, row)OverGridImageMenyisipkan gambar dalam dokumen pada baris dan kolom tertentu.
insertImage(url, column, row, offsetX, offsetY)OverGridImageMenyisipkan gambar dalam dokumen pada baris dan kolom tertentu, dengan offset piksel.
insertRowAfter(afterPosition)SheetMenyisipkan baris setelah posisi baris yang ditentukan.
insertRowBefore(beforePosition)SheetMenyisipkan baris sebelum posisi baris yang ditentukan.
insertRows(rowIndex)voidMenyisipkan baris kosong dalam sheet di lokasi yang ditentukan.
insertRows(rowIndex, numRows)voidMenyisipkan satu atau beberapa baris kosong berturut-turut dalam sheet yang dimulai pada lokasi yang ditentukan.
insertRowsAfter(afterPosition, howMany)SheetMenyisipkan jumlah baris setelah posisi baris yang ditentukan.
insertRowsBefore(beforePosition, howMany)SheetMenyisipkan jumlah baris sebelum posisi baris yang ditentukan.
insertSlicer(range, anchorRowPos, anchorColPos)SlicerMenambahkan pemotong baru ke sheet ini.
insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)SlicerMenambahkan pemotong baru ke sheet ini.
isColumnHiddenByUser(columnPosition)BooleanMenampilkan apakah kolom tertentu disembunyikan oleh pengguna.
isRightToLeft()BooleanMenampilkan true jika tata letak sheet ini kanan-ke-kiri.
isRowHiddenByFilter(rowPosition)BooleanMenampilkan apakah baris tertentu disembunyikan oleh filter (bukan tampilan filter).
isRowHiddenByUser(rowPosition)BooleanMenampilkan apakah baris tertentu disembunyikan oleh pengguna.
isSheetHidden()BooleanMenampilkan true jika sheet saat ini disembunyikan.
moveColumns(columnSpec, destinationIndex)voidMemindahkan kolom yang dipilih oleh rentang tertentu ke posisi yang ditunjukkan oleh destinationIndex.
moveRows(rowSpec, destinationIndex)voidMemindahkan baris yang dipilih oleh rentang tertentu ke posisi yang ditunjukkan oleh destinationIndex.
newChart()EmbeddedChartBuilderMenampilkan builder untuk membuat diagram baru untuk sheet ini.
protect()ProtectionMembuat objek yang dapat melindungi sheet agar tidak diedit kecuali oleh pengguna yang memiliki izin.
removeChart(chart)voidMenghapus diagram dari sheet induk.
setActiveRange(range)RangeMenetapkan rentang yang ditentukan sebagai active range dalam sheet aktif, dengan sel kiri atas dalam rentang sebagai current cell.
setActiveRangeList(rangeList)RangeListMenetapkan daftar rentang yang ditentukan sebagai active ranges di sheet aktif.
setActiveSelection(range)RangeMenetapkan region pemilihan aktif untuk sheet ini.
setActiveSelection(a1Notation)RangeMenetapkan pemilihan aktif, sebagaimana ditentukan dalam notasi A1 atau notasi R1C1.
setColumnGroupControlPosition(position)SheetMenetapkan posisi tombol kontrol grup kolom pada sheet.
setColumnWidth(columnPosition, width)SheetMenetapkan lebar kolom tertentu dalam piksel.
setColumnWidths(startColumn, numColumns, width)SheetMenetapkan lebar kolom yang ditentukan dalam piksel.
setConditionalFormatRules(rules)voidMengganti semua aturan format bersyarat yang saat ini ada di sheet dengan aturan input.
setCurrentCell(cell)RangeMenetapkan sel yang ditentukan sebagai current cell.
setFrozenColumns(columns)voidMembekukan jumlah kolom yang ditentukan.
setFrozenRows(rows)voidMembekukan jumlah baris yang ditentukan.
setHiddenGridlines(hideGridlines)SheetMenyembunyikan atau menampilkan garis petak sheet.
setName(name)SheetMenetapkan nama sheet.
setRightToLeft(rightToLeft)SheetMenyetel atau membatalkan penetapan tata letak sheet dari kanan ke kiri.
setRowGroupControlPosition(position)SheetMenetapkan posisi tombol kontrol grup baris pada sheet.
setRowHeight(rowPosition, height)SheetMenetapkan tinggi baris untuk baris tertentu dalam piksel.
setRowHeights(startRow, numRows, height)SheetMenetapkan tinggi baris tertentu dalam piksel.
setRowHeightsForced(startRow, numRows, height)SheetMenetapkan tinggi baris tertentu dalam piksel.
setTabColor(color)SheetMenetapkan warna tab sheet.
setTabColorObject(color)SheetMenetapkan warna tab sheet.
showColumns(columnIndex)voidMemperlihatkan kolom pada indeks yang diberikan.
showColumns(columnIndex, numColumns)voidMemperlihatkan satu atau beberapa kolom berurutan yang dimulai pada indeks yang diberikan.
showRows(rowIndex)voidMemperlihatkan baris pada indeks yang ditentukan.
showRows(rowIndex, numRows)voidMemperlihatkan satu atau beberapa baris berturut-turut yang dimulai pada indeks yang ditentukan.
showSheet()SheetMembuat sheet terlihat.
sort(columnPosition)SheetMengurutkan sheet berdasarkan kolom, secara menaik.
sort(columnPosition, ascending)SheetMengurutkan lembar berdasarkan kolom.
unhideColumn(column)voidMemperlihatkan kolom dalam rentang yang diberikan.
unhideRow(row)voidMemperlihatkan baris dalam rentang yang ditentukan.
updateChart(chart)voidMemperbarui diagram pada sheet ini.

Dokumentasi mendetail

activate()

Mengaktifkan sheet ini. Tidak mengubah sheet itu sendiri, hanya gagasan induk tentang sheet aktif.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.activate();

Return

Sheet — Sheet yang baru saja aktif.


addDeveloperMetadata(key)

Menambahkan metadata developer dengan kunci yang ditentukan ke sheet.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'NAME' to the developer metadata for the sheet.
sheet.addDeveloperMetadata('NAME');

// Gets the updated metadata info and logs it to the console.
console.log(sheet.getDeveloperMetadata()[0].getKey());

Parameter

NamaJenisDeskripsi
keyStringKunci untuk metadata developer baru.

Return

Sheet — Sheet ini, untuk membuat rantai.

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 sheet.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'NAME' and sets the developer metadata visibility to PROJECT
// for the sheet.
sheet.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

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

Parameter

NamaJenisDeskripsi
keyStringKunci untuk metadata developer baru.
visibilityDeveloperMetadataVisibilityVisibilitas metadata developer baru.

Return

Sheet — Sheet ini, untuk membuat rantai.

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 sheet.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'COMPANY' with the value 'TECH' to the developer metadata for the sheet.
sheet.addDeveloperMetadata('COMPANY', 'TECH');

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

Parameter

NamaJenisDeskripsi
keyStringKunci untuk metadata developer baru.
valueStringNilai untuk metadata developer baru.

Return

Sheet — Sheet ini, untuk membuat rantai.

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 sheet.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds the key 'COMPANY' with the value 'TECH' to the developer metadata and sets the
// visibility to DOCUMENT for the sheet.
sheet.addDeveloperMetadata(
  'COMPANY',
  'TECH',
  SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

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

Parameter

NamaJenisDeskripsi
keyStringKunci untuk metadata developer baru.
valueStringNilai untuk metadata developer baru.
visibilityDeveloperMetadataVisibilityVisibilitas metadata developer baru.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

appendRow(rowContents)

Menambahkan baris ke bagian bawah region data saat ini dalam sheet. Jika konten sel dimulai dengan =, konten tersebut akan ditafsirkan sebagai formula.

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

// Appends a new row with 3 columns to the bottom of the current
// data region in the sheet containing the values in the array.
sheet.appendRow(["a man", "a plan", "panama"]);

Parameter

NamaJenisDeskripsi
rowContentsObject[]Array nilai yang akan disisipkan setelah baris terakhir dalam sheet.

Return

Sheet — Sheet, berguna untuk perantaian metode.

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

asDataSourceSheet()

Menampilkan sheet sebagai DataSourceSheet jika sheet berjenis SheetType.DATASOURCE, atau null jika tidak.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the data source sheet value if the sheet is of type
// SpreadsheetApp.SheetType.DATASOURCE, otherwise this returns a null value.
const dataSourceSheet = sheet.asDataSourceSheet();

// Gets the data source sheet value and logs it to the console.
console.log(dataSourceSheet);
console.log(sheet.getType().toString());

Return

DataSourceSheet — Sheet 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

autoResizeColumn(columnPosition)

Menetapkan lebar kolom tertentu agar sesuai dengan kontennya.

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

sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...');

// Sets the first column to a width which fits the text
sheet.autoResizeColumn(1);

Parameter

NamaJenisDeskripsi
columnPositionIntegerPosisi kolom tertentu yang akan diubah ukurannya.

Return

Sheet — sheet, berguna untuk perantaian metode

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

autoResizeColumns(startColumn, numColumns)

Menetapkan lebar semua kolom yang dimulai pada posisi kolom tertentu agar sesuai dengan kontennya.

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

// Sets the first 15 columns to a width that fits their text.
sheet.autoResizeColumns(1, 15);

Parameter

NamaJenisDeskripsi
startColumnIntegerKolom awal yang ukurannya akan diubah secara otomatis.
numColumnsIntegerJumlah kolom yang ukurannya akan diubah secara otomatis.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

autoResizeRows(startRow, numRows)

Menetapkan tinggi semua baris yang dimulai dari posisi baris yang ditentukan agar sesuai dengan kontennya.

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

// Sets the first 15 rows to a height that fits their text.
sheet.autoResizeRows(1, 15);

Parameter

NamaJenisDeskripsi
startRowIntegerBaris awal akan diubah ukurannya secara otomatis.
numRowsIntegerJumlah baris yang ukurannya akan diubah secara otomatis.

Return

Sheet — Sheet ini, untuk membuat rantai.

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 sheet konten dan informasi format.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.clear();

Return

Sheet — Sheet 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

clear(options)

Menghapus sheet konten dan/atau format, seperti yang ditentukan dengan opsi lanjutan yang diberikan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.clear({ formatOnly: true, contentsOnly: true });

Parameter

NamaJenisDeskripsi
optionsObjectPeta JavaScript yang berisi opsi lanjutan, yang tercantum di bawah ini.

Parameter lanjutan

NamaJenisDeskripsi
contentsOnlyBooleanApakah konten akan dihapus atau tidak.
formatOnlyBooleanApakah akan menghapus format atau tidak.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

clearConditionalFormatRules()

Menghapus semua aturan format bersyarat dari sheet. Setara dengan memanggil setConditionalFormatRules(rules) dengan array kosong sebagai input.

var sheet = SpreadsheetApp.getActiveSheet();
sheet.clearConditionalFormatRules();

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

clearContents()

Menghapus sheet konten, sekaligus mempertahankan informasi format.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.clearContents();

Return

Sheet — Sheet ini, untuk membuat rantai.

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

clearFormats()

Menghapus sheet pemformatan, sambil mempertahankan kontennya.

Pemformatan mengacu pada cara data diformat sebagaimana diizinkan oleh pilihan pada menu "Format" (mis.: tebal, miring, pemformatan bersyarat) dan bukan lebar atau tinggi sel.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.clearFormats();

Return

Sheet — Sheet ini, untuk membuat rantai.

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

clearNotes()

Menghapus sheet dari semua catatan.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.clearNotes();

Return

Sheet — Sheet ini, untuk membuat rantai.

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

collapseAllColumnGroups()

Menciutkan semua grup kolom pada sheet.

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

// All column groups on the sheet are collapsed.
sheet.collapseAllColumnGroups();

Return

Sheet — Sheet ini, untuk membuat rantai.

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

collapseAllRowGroups()

Menciutkan semua grup baris pada sheet.

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

// All row groups on the sheet are collapsed.
sheet.collapseAllRowGroups();

Return

Sheet — Sheet ini, untuk membuat rantai.

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(spreadsheet)

Menyalin sheet ke spreadsheet tertentu, yang dapat berupa spreadsheet yang sama sebagai sumber. Sheet yang disalin diberi nama "Salinan [nama asli]".

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

var destination = SpreadsheetApp.openById('ID_GOES HERE');
sheet.copyTo(destination);

Parameter

NamaJenisDeskripsi
spreadsheetSpreadsheetSpreadsheet tujuan penyalinan sheet ini, yang dapat berupa spreadsheet yang sama dengan sumbernya.

Return

Sheet — Sheet baru, untuk membuat rantai.

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 DeveloperMetadataFinder untuk menemukan metadata developer dalam cakupan sheet ini. Metadata berada dalam cakupan sheet tertentu jika terkait dengan sheet itu sendiri, atau terkait dengan baris, kolom, atau rentang pada sheet 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds developer metadata for testing.
sheet.addDeveloperMetadata('CITY', 'PARIS');

// Creates the developer metadata finder.
const metadatafinder = sheet.createDeveloperMetadataFinder();

// Finds the metadata with value 'PARIS' and displays its key in the console.
console.log(metadatafinder.withValue('PARIS').find()[0].getKey());

Return

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


createTextFinder(findText)

Membuat pencari teks untuk sheet, yang dapat mencari dan mengganti teks dalam sheet.

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

// Creates  a text finder.
var textFinder = sheet.createTextFinder('dog');

// Returns the first occurrence of 'dog' in the sheet.
var firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var numOccurrencesReplaced = findOccurrence.replaceWith('cat');

Parameter

NamaJenisDeskripsi
findTextStringTeks yang ditelusuri.

Return

TextFinderTextFinder untuk sheet.


deleteColumn(columnPosition)

Menghapus kolom di posisi kolom tertentu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first column
sheet.deleteColumn(1);

Parameter

NamaJenisDeskripsi
columnPositionIntegerPosisi kolom, mulai dari 1 untuk kolom pertama.

Return

Sheet — sheet, berguna untuk perantaian metode

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

deleteColumns(columnPosition, howMany)

Menghapus sejumlah kolom yang dimulai pada posisi kolom tertentu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first two columns
sheet.deleteColumns(1, 2);

Parameter

NamaJenisDeskripsi
columnPositionIntegerPosisi kolom pertama yang akan dihapus.
howManyIntegerJumlah kolom yang akan 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

deleteRow(rowPosition)

Menghapus baris di posisi baris tertentu.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first row
sheet.deleteRow(1);

Parameter

NamaJenisDeskripsi
rowPositionIntegerPosisi baris, mulai dari 1 untuk baris pertama.

Return

Sheet — sheet, berguna untuk perantaian metode

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

deleteRows(rowPosition, howMany)

Menghapus sejumlah baris yang dimulai pada posisi baris yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first two rows
sheet.deleteRows(1, 2);

Parameter

NamaJenisDeskripsi
rowPositionIntegerPosisi baris pertama yang akan dihapus.
howManyIntegerJumlah baris yang akan 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

expandAllColumnGroups()

Meluaskan semua grup kolom di sheet. Metode ini memerlukan setidaknya satu grup kolom.

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

// All column groups on the sheet are expanded.
sheet.expandAllColumnGroups();

Return

Sheet — Sheet ini, untuk membuat rantai.

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

expandAllRowGroups()

Meluaskan semua grup baris pada sheet. Metode ini memerlukan setidaknya satu grup baris.

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

// All row groups on the sheet are expanded.
sheet.expandAllRowGroups();

Return

Sheet — Sheet ini, untuk membuat rantai.

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

expandColumnGroupsUpToDepth(groupDepth)

Memperluas semua grup kolom hingga kedalaman yang ditentukan dan menciutkan semua grup kolom lainnya.

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

// All column groups of depth 2 and lower are expanded, and groups with depth
// 3 and higher are collapsed.
sheet.expandColumnGroupsUpToDepth(2);

Parameter

NamaJenisDeskripsi
groupDepthIntegerKedalaman grup yang digunakan untuk meluaskan grup kolom.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

expandRowGroupsUpToDepth(groupDepth)

Meluaskan semua grup baris hingga kedalaman yang ditentukan dan menciutkan semua grup baris lainnya.

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

// All row groups of depth 2 and lower are expanded, and groups with depth
// 3 and higher are collapsed.
sheet.expandRowGroupsUpToDepth(2);

Parameter

NamaJenisDeskripsi
groupDepthIntegerKedalaman grup yang digunakan untuk meluaskan grup baris.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

getActiveCell()

Menampilkan sel aktif dalam sheet ini.

Catatan: Sebaiknya gunakan getCurrentCell() yang menampilkan sel saat ini yang ditandai.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Returns the active cell
var cell = sheet.getActiveCell();

Return

Range — sel aktif saat 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

getActiveRange()

Menampilkan rentang yang dipilih di sheet aktif, atau null jika tidak ada rentang aktif. Jika beberapa rentang dipilih, metode ini hanya menampilkan rentang terakhir yang dipilih.

Istilah "rentang aktif" mengacu pada rentang yang dipilih pengguna di sheet aktif, tetapi dalam fungsi kustom, istilah tersebut mengacu pada sel yang secara aktif dihitung ulang.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var activeRange = sheet.getActiveRange();

Return

Range — rentang aktif

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


getActiveRangeList()

Menampilkan daftar rentang aktif dalam sheet aktif atau null jika tidak ada rentang aktif.

Jika ada satu rentang yang dipilih, ini akan berperilaku sebagai panggilan getActiveRange().

var sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
var activeRangeList = sheet.getActiveRangeList();

Return

RangeList — daftar rentang aktif

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


getBandings()

Menampilkan semua garis berwarna dalam sheet 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

// Gets info on the bandings' second row color and logs it to the console.
for (const banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Return

Banding[] — Semua garis berwarna dalam sheet 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

getCharts()

Menampilkan array diagram pada sheet ini.

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

for (var i in charts) {
  var chart = charts[i];
  // Do something with the chart
}

Return

EmbeddedChart[] — Array 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

getColumnGroup(columnIndex, groupDepth)

Menampilkan grup kolom pada indeks dan kedalaman grup yang ditentukan.

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

// Returns the group whose control index is at column 2 and has a depth of 1, or
// null if the group doesn’t exist.
var columnGroup = sheet.getColumnGroup(2, 1);

Parameter

NamaJenisDeskripsi
columnIndexIntegerIndeks kolom tombol kontrol grup atau indeks dalam grup.
groupDepthIntegerKedalaman grup.

Return

Group — Grup kolom pada indeks kontrol dan kedalaman, atau menampilkan pengecualian jika grup 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

getColumnGroupControlPosition()

Menampilkan GroupControlTogglePosition untuk semua grup kolom pada sheet.

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

// GroupControlTogglePosition.AFTER if the column grouping control toggle is shown after the
// group.
var columnGroupControlPosition = sheet.getColumnGroupControlPosition();

Return

GroupControlTogglePositiontrue jika tombol kontrol pengelompokan kolom ditampilkan setelah grup pada sheet ini dan 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

getColumnGroupDepth(columnIndex)

Menampilkan kedalaman grup kolom pada indeks yang diberikan.

Kedalaman grup menunjukkan jumlah grup yang tumpang-tindih dengan kolom. Rentangnya bisa antara nol dan delapan.

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

// 1 if there is a group over columns 1 through 3
var groupDepth = sheet.getColumnGroupDepth(1);

Parameter

NamaJenisDeskripsi
columnIndexIntegerIndeks kolom.

Return

Integer — Kedalaman grup kolom pada indeks 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

getColumnWidth(columnPosition)

Mendapatkan lebar kolom yang ditentukan dalam piksel.

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

// Columns start at 1
Logger.log(sheet.getColumnWidth(1));

Parameter

NamaJenisDeskripsi
columnPositionIntegerPosisi kolom yang akan diperiksa.

Return

Integer — lebar kolom dalam piksel

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

getConditionalFormatRules()

Dapatkan semua aturan format bersyarat dalam sheet ini.

// Logs the conditional format rules in a sheet.
var rules = SpreadsheetApp.getActiveSheet().getConditionalFormatRules();
for (var i = 0; i < rules.length; i++) {
  var rule = rules[i];
  Logger.log(rule);
}

Return

ConditionalFormatRule[] — Array dari semua aturan dalam sheet.

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

getCurrentCell()

Menampilkan sel saat ini dalam sheet aktif atau null jika tidak ada sel saat ini. Sel saat ini adalah sel yang memiliki fokus di UI Google Spreadsheet, dan ditandai dengan batas gelap. Jumlah sel saat ini tidak pernah lebih dari satu. Saat pengguna memilih satu atau beberapa rentang sel, salah satu sel yang dipilih adalah sel saat ini.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
// Returns the current highlighted cell in the one of the active ranges.
var currentCell = sheet.getCurrentCell();

Return

Range — sel saat 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

getDataRange()

Menampilkan Range yang sesuai dengan dimensi yang berisi data.

Secara fungsional, tindakan ini sama dengan membuat Rentang yang dibatasi oleh A1 dan (Sheet.getLastColumn(), Sheet.getLastRow()).

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

// This represents ALL the data
var range = sheet.getDataRange();
var values = range.getValues();

// This logs the spreadsheet in CSV format with a trailing comma
for (var i = 0; i < values.length; i++) {
  var row = "";
  for (var j = 0; j < values[i].length; j++) {
    if (values[i][j]) {
      row = row + values[i][j];
    }
    row = row + ",";
  }
  Logger.log(row);
}

Return

Range — rentang yang terdiri dari semua data 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

getDataSourceFormulas()

Mendapatkan semua formula sumber data.

// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets
// file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of the data source formulas on Sheet1.
// To get an array of data source formulas for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceFormulas = sheet.getDataSourceFormulas();

// Logs the first data source formula in the array.
console.log(dataSourceFormulas[0].getFormula());

Return

DataSourceFormula[] — Daftar formula 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

getDataSourcePivotTables()

Mendapatkan semua tabel pivot 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 an array of the data source pivot tables on Sheet1.
// To get an array of data source pivot tables for the entire
// spreadsheet, replace 'sheet' with 'ss'.
const dataSourcePivotTables = sheet.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

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 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 an array of data source tables on Sheet1.
// To get an array of data source tables for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceTables = sheet.getDataSourceTables();

// Logs the last completed data execution time on the first data source table.
console.log(dataSourceTables[0].getStatus().getLastExecutionTime());

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

getDeveloperMetadata()

Dapatkan semua metadata developer yang terkait dengan sheet 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Adds developer metadata for testing.
sheet.addDeveloperMetadata('CITY', 'PARIS');

// Gets all the developer metadata for the sheet.
const developerMetaDataList = sheet.getDeveloperMetadata();

// Logs the developer metadata to the console.
for (const developerMetaData of developerMetaDataList) {
  console.log(developerMetaData.getKey());
}

Return

DeveloperMetadata[] — Metadata developer yang terkait dengan sheet 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

getDrawings()

Menampilkan array gambar pada sheet.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all the drawings from the sheet.
const allDrawings = sheet.getDrawings();

 // Logs the number of drawings present on the sheet.
console.log(allDrawings.length);

Return

Drawing[] — Daftar gambar di sheet 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

getFilter()

Menampilkan filter dalam sheet ini, atau null jika tidak ada filter.

// Gets the filter on the active sheet.
let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.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

getFormUrl()

Menampilkan URL untuk formulir yang mengirim responsnya ke sheet ini, atau null jika sheet ini tidak memiliki formulir terkait.

var sheet = SpreadsheetApp.getActiveSheet();
var url = sheet.getFormUrl();

Return

String — URL untuk formulir yang menempatkan responsnya dalam sheet ini, atau null jika sheet ini tidak memiliki formulir terkait.

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

getFrozenColumns()

Menampilkan jumlah kolom yang dibekukan.

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

Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());

Return

Integer — jumlah kolom yang dibekukan

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

getFrozenRows()

Menampilkan jumlah baris yang dibekukan.

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

Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());

Return

Integer — jumlah baris beku

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

getImages()

Menampilkan semua gambar di petak pada sheet.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the over-the-grid images from Sheet1.
// To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead.
const images = sheet.getImages();

// For each image, logs the anchor cell in A1 notation.
for (const image of images) {
 console.log(image.getAnchorCell().getA1Notation());
}

Return

OverGridImage[] — Array gambar yang terhubung ke petak.

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

getIndex()

Mendapatkan posisi sheet di spreadsheet induknya. Dimulai dari 1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
// Note that the JavaScript index is 0, but this logs 1
var sheet = ss.getSheets()[0];
// ... because spreadsheets are 1-indexed
Logger.log(sheet.getIndex());

Return

Integer — Posisi sheet di spreadsheet induknya.

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 terakhir yang memiliki konten.

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

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Return

Integer — kolom terakhir pada sheet yang berisi konten

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 terakhir yang memiliki konten.

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

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Return

Integer — baris terakhir sheet yang berisi konten

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

getMaxColumns()

Menampilkan jumlah kolom saat ini dalam sheet, apa pun kontennya.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
Logger.log(first.getMaxColumns());

Return

Integer — Lebar maksimum sheet.

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

getMaxRows()

Menampilkan jumlah baris saat ini dalam sheet, apa pun kontennya.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
Logger.log(first.getMaxRows());

Return

Integer — Tinggi maksimum sheet.

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

getName()

Menampilkan nama sheet.

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

Return

String — Nama sheet.

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

getNamedRanges()

Mendapatkan semua rentang bernama dalam sheet ini.

// The code below logs the name of the first named range.
var namedRanges = SpreadsheetApp.getActiveSheet().getNamedRanges();
if (namedRanges.length > 1) {
  Logger.log(namedRanges[0].getName());
}

Return

NamedRange[] — Array dari semua rentang bernama dalam sheet.

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

getParent()

Menampilkan Spreadsheet yang berisi sheet ini.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// parent is identical to ss
var parent = sheet.getParent();

Return

Spreadsheet — Spreadsheet 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

getPivotTables()

Menampilkan semua tabel pivot pada sheet 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all the pivot table info for the sheet.
const pivotTables = sheet.getPivotTables();

// Logs the pivot tables to the console.
for (const pivotTable of pivotTables) {
  console.log(pivotTable.getSourceDataRange().getValues());
}

Return

PivotTable[] — Tabel pivot pada sheet 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

getProtections(type)

Mendapatkan array objek yang mewakili semua rentang dilindungi dalam sheet, atau array elemen tunggal yang mewakili perlindungan pada sheet itu sendiri.

// Remove all range protections in the spreadsheet that the user has permission to edit.
var sheet = SpreadsheetApp.getActiveSheet();
var protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}
// Remove sheet protection from the active sheet, if the user has permission to edit it.
var sheet = SpreadsheetApp.getActiveSheet();
var protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0];
if (protection && protection.canEdit()) {
  protection.remove();
}

Parameter

NamaJenisDeskripsi
typeProtectionTypeJenis kawasan yang dilindungi, SpreadsheetApp.ProtectionType.RANGE atau SpreadsheetApp.ProtectionType.SHEET.

Return

Protection[] — Array objek yang mewakili semua rentang dilindungi dalam sheet, atau array elemen tunggal yang merepresentasikan perlindungan pada sheet itu sendiri.

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

getRange(row, column)

Menampilkan rentang dengan sel kiri atas pada koordinat yang diberikan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Passing only two arguments returns a "range" with a single cell.
var range = sheet.getRange(1, 1);
var values = range.getValues();
Logger.log(values[0][0]);

Parameter

NamaJenisDeskripsi
rowIntegerIndeks baris dari sel yang akan ditampilkan; pengindeksan baris dimulai dengan 1.
columnIntegerIndeks kolom dari sel yang akan dikembalikan; pengindeksan kolom dimulai dengan 1.

Return

Range — Rentang yang hanya berisi 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

getRange(row, column, numRows)

Menampilkan rentang dengan sel kiri atas pada koordinat yang ditentukan, dan dengan jumlah baris yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// When the "numRows" argument is used, only a single column of data is returned.
var range = sheet.getRange(1, 1, 3);
var values = range.getValues();

// Prints 3 values from the first column, starting from row 1.
for (var row in values) {
  for (var col in values[row]) {
    Logger.log(values[row][col]);
  }
}

Parameter

NamaJenisDeskripsi
rowIntegerIndeks baris awal rentang; pengindeksan baris dimulai dengan 1.
columnIntegerIndeks kolom rentang; pengindeksan kolom dimulai dengan 1.
numRowsIntegerJumlah baris yang akan ditampilkan.

Return

Range — Rentang yang berisi satu kolom data dengan jumlah baris 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

getRange(row, column, numRows, numColumns)

Menampilkan rentang dengan sel kiri atas pada koordinat yang ditentukan dengan jumlah baris dan kolom yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange(1, 1, 3, 3);
var values = range.getValues();

// Print values from a 3x3 box.
for (var row in values) {
  for (var col in values[row]) {
    Logger.log(values[row][col]);
  }
}

Parameter

NamaJenisDeskripsi
rowIntegerIndeks baris awal rentang; pengindeksan baris dimulai dengan 1.
columnIntegerIndeks kolom awal rentang; pengindeksan kolom dimulai dengan 1.
numRowsIntegerJumlah baris yang akan ditampilkan.
numColumnsIntegerJumlah kolom yang akan ditampilkan.

Return

Range — Rentang yang sesuai dengan area 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

getRange(a1Notation)

Menampilkan rentang seperti yang ditentukan dalam notasi A1 atau notasi R1C1.

// Get a range A1:D4 on sheet titled "Invoices"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var range = ss.getRange("Invoices!A1:D4");

// Get cell A1 on the first sheet
var sheet = ss.getSheets()[0];
var cell = sheet.getRange("A1");

Parameter

NamaJenisDeskripsi
a1NotationStringRentang yang akan ditampilkan, seperti yang ditentukan dalam notasi A1 atau notasi R1C1.

Return

Range — rentang di lokasi yang ditetapkan

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

getRangeList(a1Notations)

Menampilkan koleksi RangeList yang merepresentasikan rentang dalam sheet yang sama yang ditentukan oleh daftar notasi A1 atau notasi R1C1 yang tidak kosong.

// Get a list of ranges A1:D4, F1:H4.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var rangeList  = sheet.getRangeList(['A1:D4', 'F1:H4']);

Parameter

NamaJenisDeskripsi
a1NotationsString[]Daftar rentang yang akan ditampilkan, seperti yang ditentukan dalam notasi A1 atau notasi R1C1.

Return

RangeList — daftar rentang di lokasi yang ditetapkan

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

getRowGroup(rowIndex, groupDepth)

Menampilkan grup baris pada indeks dan kedalaman grup yang ditentukan.

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

// Returns the group whose control index is at row 2 and has a depth of 1, or
// null if the group doesn’t exist.
var rowGroup = sheet.getRowGroup(2, 1);

Parameter

NamaJenisDeskripsi
rowIndexIntegerIndeks baris tombol kontrol grup atau indeks dalam grup.
groupDepthIntegerKedalaman grup.

Return

Group — Grup baris pada indeks kontrol dan kedalaman, atau menampilkan pengecualian jika grup 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

getRowGroupControlPosition()

Menampilkan GroupControlTogglePosition untuk semua grup baris pada sheet.

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

// GroupControlTogglePosition.AFTER if the row grouping control toggle is shown after the
// group.
var rowGroupControlPosition = sheet.getRowGroupControlPosition();

Return

GroupControlTogglePositiontrue jika tombol kontrol pengelompokan baris ditampilkan setelah grup pada sheet ini, dan 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

getRowGroupDepth(rowIndex)

Menampilkan kedalaman grup baris pada indeks yang diberikan.

Kedalaman grup menunjukkan jumlah grup yang tumpang-tindih dengan baris. Rentangnya bisa antara nol dan delapan.

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

// 1 if there is a group over rows 1 through 3
var groupDepth = sheet.getRowGroupDepth(1);

Parameter

NamaJenisDeskripsi
rowIndexIntegerIndeks baris.

Return

Integer — Kedalaman grup baris pada indeks 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

getRowHeight(rowPosition)

Mendapatkan tinggi baris yang ditentukan dalam piksel.

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

// Rows start at 1
Logger.log(sheet.getRowHeight(1));

Parameter

NamaJenisDeskripsi
rowPositionIntegerPosisi baris yang akan diperiksa.

Return

Integer — tinggi baris dalam piksel

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

getSelection()

Menampilkan Selection saat ini di spreadsheet.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var currentCell = selection.getCurrentCell();

Return

Selection — pilihan saat 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

getSheetId()

Menampilkan ID sheet yang direpresentasikan oleh objek ini.

Ini adalah ID untuk sheet yang unik untuk {i>spreadsheet<i}. ID adalah bilangan bulat yang meningkat secara monoton yang ditetapkan pada waktu pembuatan sheet yang tidak bergantung pada posisi sheet. Hal ini berguna bersama dengan metode seperti Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd) yang menggunakan parameter gridId, bukan instance Sheet.

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

Logger.log(sheet.getSheetId());

Return

Integer — ID untuk sheet unik bagi 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

getSheetName()

Menampilkan nama sheet.

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

Logger.log(sheet.getSheetName());

Return

String — nama sheet

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

getSheetValues(startRow, startColumn, numRows, numColumns)

Menampilkan nilai kisi persegi panjang untuk rentang ini mulai dari koordinat yang diberikan. Nilai -1 yang diberikan sebagai posisi baris atau kolom setara dengan mendapatkan baris atau kolom terakhir yang memiliki data di sheet.

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

// The two samples below produce the same output
var values = sheet.getSheetValues(1, 1, 3, 3);
Logger.log(values);

var range = sheet.getRange(1, 1, 3, 3);
values = range.getValues();
Logger.log(values);

Parameter

NamaJenisDeskripsi
startRowIntegerPosisi baris awal.
startColumnIntegerPosisi kolom awal.
numRowsIntegerJumlah baris yang nilainya akan ditampilkan.
numColumnsIntegerJumlah kolom yang nilainya akan ditampilkan.

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

getSlicers()

Menampilkan array pemotong pada sheet.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets all slicers in the spreadsheet.
const slicers = sheet.getSlicers();

// Logs the slicer titles to the console.
for (const slicer of slicers) {
  console.log(slicer.getTitle());
}

Return

Slicer[] — Daftar pemotong pada sheet 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

getTabColorObject()

Mendapatkan warna tab sheet, atau null jika tab sheet tidak memiliki warna.

// This example assumes there is a sheet named "Sheet1"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("Sheet1");
var color = first.getTabColorObject();

Return

Color — Warna tab sheet, atau null jika tab sheet tidak memiliki warna.

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

getType()

Menampilkan jenis sheet.

Jenis sheet default adalah SheetType.GRID. Sheet yang berisi satu objek yang disematkan seperti EmbeddedChart adalah sheet SheetType.OBJECT.

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

Return

SheetType — Jenis sheet.

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

hasHiddenGridlines()

Menampilkan true jika garis petak sheet disembunyikan; jika tidak, menampilkan false. Garis petak terlihat secara default.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Checks if the spreadsheet has hidden gridelines and logs the result to the console.
console.log(sheet.hasHiddenGridlines());

Return

Booleantrue jika garis petak disembunyikan; 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

hideColumn(column)

Menyembunyikan satu atau beberapa kolom dalam rentang yang diberikan.

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

// This hides the first column
let range = sheet.getRange("A1");
sheet.hideColumn(range);

// This hides the first 3 columns
let range = sheet.getRange("A:C");
sheet.hideColumn(range);

Parameter

NamaJenisDeskripsi
columnRangeRentang kolom yang akan disembunyikan.

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

hideColumns(columnIndex)

Menyembunyikan satu kolom pada indeks yang diberikan. Gunakan 1-indeks untuk metode ini.

Untuk menyembunyikan lebih dari satu kolom menggunakan indeks, gunakan hideColumns(columnIndex, numColumns).

Untuk menyembunyikan lebih dari satu kolom menggunakan rentang, gunakan hideColumn().

let ss = SpreadsheetApp.getActiveSpreadsheet();
let sheet = ss.getSheets()[0];
// Hides the first column
sheet.hideColumns(1);

Parameter

NamaJenisDeskripsi
columnIndexIntegerIndeks kolom yang akan disembunyikan.

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

hideColumns(columnIndex, numColumns)

Menyembunyikan satu atau beberapa kolom berturut-turut yang dimulai pada indeks yang diberikan. Gunakan 1-indeks untuk metode ini.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Hides the first three columns
sheet.hideColumns(1, 3);

Parameter

NamaJenisDeskripsi
columnIndexIntegerIndeks awal kolom yang akan disembunyikan.
numColumnsIntegerJumlah kolom yang akan disembunyikan.

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

hideRow(row)

Menyembunyikan baris dalam rentang yang diberikan.

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

// This hides the first row
var range = sheet.getRange("A1");
sheet.hideRow(range);

Parameter

NamaJenisDeskripsi
rowRangeRentang baris yang akan disembunyikan.

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

hideRows(rowIndex)

Menyembunyikan baris pada indeks yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Hides the first row
sheet.hideRows(1);

Parameter

NamaJenisDeskripsi
rowIndexIntegerIndeks baris yang akan disembunyikan.

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

hideRows(rowIndex, numRows)

Menyembunyikan satu atau beberapa baris berturut-turut yang dimulai pada indeks yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Hides the first three rows
sheet.hideRows(1, 3);

Parameter

NamaJenisDeskripsi
rowIndexIntegerIndeks awal baris yang akan disembunyikan.
numRowsIntegerJumlah baris yang akan disembunyikan.

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

hideSheet()

Menyembunyikan sheet ini. Tidak berpengaruh jika sheet sudah disembunyikan. Jika metode ini dipanggil pada satu-satunya sheet yang terlihat, metode tersebut akan menampilkan pengecualian.

var sheet = SpreadsheetApp.getActiveSheet();
sheet.hideSheet();

Return

Sheet — Sheet saat 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

insertChart(chart)

Menambahkan diagram baru ke sheet ini.

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

// This creates a simple bar chart from the first three rows
// of the first two columns of the spreadsheet
var chart = sheet.newChart()
    .setChartType(Charts.ChartType.BAR)
    .addRange(sheet.getRange("A1:B4"))
    .setPosition(5, 5, 0, 0)
    .setOption("title", "Dynamic Chart")
    .build();
sheet.insertChart(chart);

Parameter

NamaJenisDeskripsi
chartEmbeddedChartDiagram yang akan disisipkan.

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

insertColumnAfter(afterPosition)

Menyisipkan kolom setelah posisi kolom yang ditentukan.

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

// This inserts a column after the first column position
sheet.insertColumnAfter(1);

Parameter

NamaJenisDeskripsi
afterPositionIntegerKolom yang akan ditambahi kolom baru.

Return

Sheet — sheet, berguna untuk perantaian metode

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

insertColumnBefore(beforePosition)

Menyisipkan kolom sebelum posisi kolom yang ditentukan.

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

// This inserts a column in the first column position
sheet.insertColumnBefore(1);

Parameter

NamaJenisDeskripsi
beforePositionIntegerKolom yang akan ditambahi kolom baru.

Return

Sheet — sheet, berguna untuk perantaian metode

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

insertColumns(columnIndex)

Menyisipkan kolom kosong dalam sheet di lokasi yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Shifts all columns by one
sheet.insertColumns(1);

Parameter

NamaJenisDeskripsi
columnIndexIntegerIndeks yang menunjukkan tempat untuk menyisipkan kolom.

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

insertColumns(columnIndex, numColumns)

Menyisipkan satu atau beberapa kolom kosong berturut-turut dalam sheet yang dimulai pada lokasi yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Shifts all columns by three
sheet.insertColumns(1, 3);

Parameter

NamaJenisDeskripsi
columnIndexIntegerIndeks yang menunjukkan tempat untuk menyisipkan kolom.
numColumnsIntegerJumlah kolom yang akan disisipkan.

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

insertColumnsAfter(afterPosition, howMany)

Menyisipkan jumlah kolom tertentu setelah posisi kolom yang ditentukan.

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

// Inserts two columns after the first column on the first sheet of the spreadsheet.
sheet.insertColumnsAfter(1,2);

Parameter

NamaJenisDeskripsi
afterPositionIntegerKolom yang akan ditambahi kolom baru.
howManyIntegerJumlah kolom yang akan disisipkan.

Return

Sheet — sheet, berguna untuk perantaian metode

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

insertColumnsBefore(beforePosition, howMany)

Menyisipkan jumlah kolom sebelum posisi kolom tertentu.

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

// This inserts five columns before the first column
sheet.insertColumnsBefore(1, 5);

Parameter

NamaJenisDeskripsi
beforePositionIntegerKolom yang akan ditambahi kolom baru.
howManyIntegerJumlah kolom yang akan disisipkan.

Return

Sheet — sheet, berguna untuk perantaian metode

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

insertImage(blobSource, column, row)

Menyisipkan BlobSource sebagai gambar dalam dokumen pada baris dan kolom tertentu. Ukuran gambar diambil dari konten blob. Ukuran blob maksimum yang didukung adalah 2 MB.

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

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1);

Parameter

NamaJenisDeskripsi
blobSourceBlobSourceBlob yang berisi konten gambar, jenis MIME, dan nama (opsional).
columnIntegerPosisi kolom.
rowIntegerPosisi baris.

Return

OverGridImage — Gambar yang disisipkan.

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

insertImage(blobSource, column, row, offsetX, offsetY)

Menyisipkan BlobSource sebagai gambar dalam dokumen pada baris dan kolom tertentu, dengan offset piksel. Ukuran gambar diambil dari konten blob. Ukuran blob maksimum yang didukung adalah 2 MB.

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

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1, 10, 10);

Parameter

NamaJenisDeskripsi
blobSourceBlobSourceBlob yang berisi konten gambar, jenis MIME, dan nama (opsional).
columnIntegerPosisi kolom.
rowIntegerPosisi baris.
offsetXIntegerOffset horizontal dari sudut sel dalam piksel.
offsetYIntegerOffset vertikal dari sudut sel dalam piksel.

Return

OverGridImage — Gambar yang disisipkan.

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

insertImage(url, column, row)

Menyisipkan gambar dalam dokumen pada baris dan kolom tertentu.

URL yang diberikan harus dapat diakses secara publik.

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

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);

Parameter

NamaJenisDeskripsi
urlStringURL gambar.
columnIntegerPosisi kolom petak.
rowIntegerPosisi baris petak.

Return

OverGridImage — Gambar yang disisipkan.

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

insertImage(url, column, row, offsetX, offsetY)

Menyisipkan gambar dalam dokumen pada baris dan kolom tertentu, dengan offset piksel.

URL yang diberikan harus dapat diakses secara publik.

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

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);

Parameter

NamaJenisDeskripsi
urlStringURL untuk gambar.
columnIntegerPosisi kolom.
rowIntegerPosisi baris.
offsetXIntegerOffset horizontal dari sudut sel dalam piksel.
offsetYIntegerOffset vertikal dari sudut sel dalam piksel.

Return

OverGridImage — Gambar yang disisipkan.

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

insertRowAfter(afterPosition)

Menyisipkan baris setelah posisi baris yang ditentukan.

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

// This inserts a row after the first row position
sheet.insertRowAfter(1);

Parameter

NamaJenisDeskripsi
afterPositionIntegerBaris yang akan ditambahi baris baru.

Return

Sheet — sheet, berguna untuk perantaian metode

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

insertRowBefore(beforePosition)

Menyisipkan baris sebelum posisi baris yang ditentukan.

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

// This inserts a row before the first row position
sheet.insertRowBefore(1);

Parameter

NamaJenisDeskripsi
beforePositionIntegerBaris yang akan ditambahi baris baru.

Return

Sheet — sheet, berguna untuk perantaian metode

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

insertRows(rowIndex)

Menyisipkan baris kosong dalam sheet di lokasi yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Shifts all rows down by one
sheet.insertRows(1);

Parameter

NamaJenisDeskripsi
rowIndexIntegerIndeks yang menunjukkan tempat untuk menyisipkan baris.

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

insertRows(rowIndex, numRows)

Menyisipkan satu atau beberapa baris kosong berturut-turut dalam sheet yang dimulai pada lokasi yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Shifts all rows down by three
sheet.insertRows(1, 3);

Parameter

NamaJenisDeskripsi
rowIndexIntegerIndeks yang menunjukkan tempat untuk menyisipkan baris.
numRowsIntegerJumlah baris yang akan disisipkan.

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

insertRowsAfter(afterPosition, howMany)

Menyisipkan jumlah baris setelah posisi baris yang ditentukan.

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

// This inserts five rows after the first row
sheet.insertRowsAfter(1, 5);

Parameter

NamaJenisDeskripsi
afterPositionIntegerBaris yang akan ditambahi baris baru.
howManyIntegerJumlah baris yang akan disisipkan.

Return

Sheet — sheet, berguna untuk perantaian metode

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

insertRowsBefore(beforePosition, howMany)

Menyisipkan jumlah baris sebelum posisi baris yang ditentukan.

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

// This inserts five rows before the first row
sheet.insertRowsBefore(1, 5);

Parameter

NamaJenisDeskripsi
beforePositionIntegerBaris yang akan ditambahi baris baru.
howManyIntegerJumlah baris yang akan disisipkan.

Return

Sheet — sheet, berguna untuk perantaian metode

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

insertSlicer(range, anchorRowPos, anchorColPos)

Menambahkan pemotong baru ke sheet 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

// Inserts the slicer with a random range into the sheet.
const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10);

// Logs the insert slicer result to the console.
console.log(insertSlicers);

Parameter

NamaJenisDeskripsi
rangeRangeRentang tempat pemotong pemotong dibuat.
anchorRowPosIntegerSisi atas pemotong ditambatkan di baris ini.
anchorColPosIntegerSisi atas pemotong ditambatkan di kolom ini.

Return

Slicer — Pemotong yang baru disisipkan.

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

insertSlicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)

Menambahkan pemotong baru ke sheet 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 a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

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

// Inserts a slicer using the random range function.
const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10, 0, 0);

// Logs the insert slicer result to the console.
console.log(insertSlicers);

Parameter

NamaJenisDeskripsi
rangeRangeRentang tempat pemotong pemotong dibuat.
anchorRowPosIntegerSisi atas pemotong ditambatkan di baris ini.
anchorColPosIntegerSisi atas pemotong ditambatkan di kolom ini.
offsetXIntegerOffset horizontal dari sudut sel dalam piksel.
offsetYIntegerOffset vertikal dari sudut sel dalam piksel.

Return

Slicer — Pemotong yang baru disisipkan.

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

isColumnHiddenByUser(columnPosition)

Menampilkan apakah kolom tertentu disembunyikan oleh pengguna.

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

// Columns start at 1
Logger.log(sheet.isColumnHiddenByUser(1));

Parameter

NamaJenisDeskripsi
columnPositionIntegerPosisi kolom yang akan diperiksa.

Return

Booleantrue jika kolom disembunyikan, 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

isRightToLeft()

Menampilkan true jika tata letak sheet ini kanan-ke-kiri. Menampilkan false jika sheet menggunakan tata letak default kiri-ke-kanan.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Checks if a spreadsheet is ordered from right to left and logs the result to the console.
console.log(sheet.isRightToLeft());

Return

Booleantrue jika kanan-ke-kiri; 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

isRowHiddenByFilter(rowPosition)

Menampilkan apakah baris tertentu disembunyikan oleh filter (bukan tampilan filter).

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

// Rows start at 1
Logger.log(sheet.isRowHiddenByFilter(1));

Parameter

NamaJenisDeskripsi
rowPositionIntegerPosisi baris yang akan diperiksa.

Return

Booleantrue jika baris disembunyikan, 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

isRowHiddenByUser(rowPosition)

Menampilkan apakah baris tertentu disembunyikan oleh pengguna.

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

// Rows start at 1
Logger.log(sheet.isRowHiddenByUser(1));

Parameter

NamaJenisDeskripsi
rowPositionIntegerPosisi baris yang akan diperiksa.

Return

Booleantrue jika baris disembunyikan, 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

isSheetHidden()

Menampilkan true jika sheet saat ini disembunyikan.

var sheet = SpreadsheetApp.getActiveSheet();
if (sheet.isSheetHidden()) {
  // do something...
}

Return

Booleantrue jika sheet disembunyikan, 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

moveColumns(columnSpec, destinationIndex)

Memindahkan kolom yang dipilih oleh rentang tertentu ke posisi yang ditunjukkan oleh destinationIndex. columnSpec sendiri tidak harus secara persis merepresentasikan seluruh kolom atau grup kolom yang akan dipindahkan—opsi ini memilih semua kolom yang dicakup oleh rentang tersebut.

// The code below moves rows A-B to destination index 5.
// This results in those columns becoming columns C-D.
var sheet = SpreadsheetApp.getActiveSheet();
// Selects column A and column B to be moved.
var columnSpec = sheet.getRange("A1:B1");
sheet.moveColumns(columnSpec, 5);

Parameter

NamaJenisDeskripsi
columnSpecRangeRentang yang mencakup kolom yang harus dipindahkan.
destinationIndexIntegerIndeks yang menjadi tujuan pemindahan kolom. Perhatikan bahwa indeks ini didasarkan pada koordinat sebelum kolom dipindahkan. Data yang ada digeser ke kanan untuk memberi ruang bagi kolom yang dipindahkan, sementara kolom sumber dihapus dari petak. Oleh karena itu, data mungkin berakhir pada indeks yang berbeda dari yang telah ditentukan semula.

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

moveRows(rowSpec, destinationIndex)

Memindahkan baris yang dipilih oleh rentang tertentu ke posisi yang ditunjukkan oleh destinationIndex. rowSpec sendiri tidak harus secara persis merepresentasikan seluruh baris atau grup baris yang akan dipindahkan—opsi ini memilih semua baris yang membentang dalam rentang tersebut.

// The code below moves rows 1-2 to destination index 5.
// This results in those rows becoming rows 3-4.
var sheet = SpreadsheetApp.getActiveSheet();
// Selects row 1 and row 2 to be moved.
var rowSpec = sheet.getRange("A1:A2");
sheet.moveRows(rowSpec, 5);

Parameter

NamaJenisDeskripsi
rowSpecRangeRentang yang mencakup baris yang harus dipindahkan.
destinationIndexIntegerIndeks yang menjadi tujuan pemindahan baris. Perhatikan bahwa indeks ini didasarkan pada koordinat sebelum baris dipindahkan. Data yang ada digeser ke bawah untuk memberi ruang bagi baris yang dipindahkan sementara baris sumber dihapus dari petak. Oleh karena itu, data mungkin berakhir pada indeks yang berbeda dari yang ditentukan semula.

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

newChart()

Menampilkan builder untuk membuat diagram baru untuk sheet ini.

Contoh ini menunjukkan cara membuat diagram baru:

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B8");
var chartBuilder = sheet.newChart();
chartBuilder.addRange(range)
    .setChartType(Charts.ChartType.LINE)
    .setPosition(2, 2, 0, 0)
    .setOption('title', 'My Line Chart!');
sheet.insertChart(chartBuilder.build());

Return

EmbeddedChartBuilder — Builder untuk membuat diagram baru.


protect()

Membuat objek yang dapat melindungi sheet agar tidak diedit kecuali oleh pengguna yang memiliki izin. Hingga skrip benar-benar mengubah daftar editor untuk sheet (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 mencerminkan izin dari spreadsheet itu sendiri, yang secara efektif berarti bahwa sheet tersebut tetap tidak terlindungi. Jika sheet sudah dilindungi, metode ini akan menampilkan objek yang mewakili setelan perlindungan yang ada. Sheet yang dilindungi mungkin menyertakan bagian yang tidak dilindungi.

// Protect the active sheet, then remove all other users from the list of editors.
var sheet = SpreadsheetApp.getActiveSheet();
var protection = sheet.protect().setDescription('Sample protected sheet');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Return

Protection — Objek yang mewakili 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

removeChart(chart)

Menghapus diagram dari sheet induk.

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

// This removes all the embedded charts from the spreadsheet
var charts = sheet.getCharts();
for (var i in charts) {
  sheet.removeChart(charts[i]);
}

Parameter

NamaJenisDeskripsi
chartEmbeddedChartDiagram yang akan 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

setActiveRange(range)

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

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var range = sheet.getRange('A1:D4');
sheet.setActiveRange(range);

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

Parameter

NamaJenisDeskripsi
rangeRangeRentang untuk ditetapkan sebagai rentang aktif.

Return

Range — rentang yang baru aktif

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

setActiveRangeList(rangeList)

Menetapkan daftar rentang yang ditentukan sebagai active ranges di sheet aktif. Rentang terakhir dalam daftar ditetapkan sebagai active range.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
sheet.setActiveRangeList(rangeList);

var selection = sheet.getSelection();
// Current cell: B2
var currentCell = selection.getCurrentCell();
// Active range: B2:C4
var activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
var activeRangeList = selection.getActiveRangeList();

Parameter

NamaJenisDeskripsi
rangeListRangeListDaftar rentang yang dapat dipilih.

Return

RangeList — daftar rentang yang baru dipilih

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

setActiveSelection(range)

Menetapkan region pemilihan aktif untuk sheet ini.

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

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

Parameter

NamaJenisDeskripsi
rangeRangeRentang untuk ditetapkan sebagai pilihan aktif.

Return

Range — rentang yang baru aktif

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

setActiveSelection(a1Notation)

Menetapkan pemilihan aktif, sebagaimana ditentukan dalam notasi A1 atau notasi R1C1.

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

sheet.setActiveSelection("A1:D4");

Parameter

NamaJenisDeskripsi
a1NotationStringRentang yang akan ditetapkan sebagai aktif, seperti yang ditentukan dalam notasi A1 atau notasi R1C1.

Return

Range — rentang yang baru aktif

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

setColumnGroupControlPosition(position)

Menetapkan posisi tombol kontrol grup kolom pada sheet.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setColumnGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);

Parameter

NamaJenisDeskripsi
positionGroupControlTogglePositionPosisi tombol kontrol grup kolom.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

setColumnWidth(columnPosition, width)

Menetapkan lebar kolom tertentu dalam piksel.

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

// Sets the first column to a width of 200 pixels
sheet.setColumnWidth(1, 200);

Parameter

NamaJenisDeskripsi
columnPositionIntegerPosisi kolom tertentu yang akan ditetapkan.
widthIntegerLebar dalam piksel yang ditetapkan.

Return

Sheet — sheet, berguna untuk perantaian metode

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

setColumnWidths(startColumn, numColumns, width)

Menetapkan lebar kolom yang ditentukan dalam piksel.

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

// Sets the first three columns to a width of 200 pixels
sheet.setColumnWidths(1, 3, 200);

Parameter

NamaJenisDeskripsi
startColumnIntegerPosisi kolom awal yang akan diubah.
numColumnsIntegerJumlah kolom yang akan diubah.
widthIntegerLebar dalam piksel yang ditetapkan.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

setConditionalFormatRules(rules)

Mengganti semua aturan format bersyarat yang saat ini ada di sheet dengan aturan input. Aturan dievaluasi dalam urutan inputnya.

// Remove one of the existing conditional format rules.
var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
rules.splice(1, 1); // Deletes the 2nd format rule.
sheet.setConditionalFormatRules(rules);

Parameter

NamaJenisDeskripsi
rulesConditionalFormatRule[]Aturan format bersyarat 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

setCurrentCell(cell)

Menetapkan sel yang ditentukan sebagai current cell.

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

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

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

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var cell = sheet.getRange('B5');
sheet.setCurrentCell(cell);

var selection = sheet.getSelection();
// Current cell: B5
var currentCell = selection.getCurrentCell();

Parameter

NamaJenisDeskripsi
cellRangeSel yang akan ditetapkan sebagai sel saat ini.

Return

Range — sel saat ini yang baru ditetapkan

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

setFrozenColumns(columns)

Membekukan jumlah kolom yang ditentukan. Jika nol, tidak ada kolom yang dibekukan.

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

// Freezes the first column
sheet.setFrozenColumns(1);

Parameter

NamaJenisDeskripsi
columnsIntegerJumlah kolom yang akan dibekukan.

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

setFrozenRows(rows)

Membekukan jumlah baris yang ditentukan. Jika nol, tidak ada baris yang dibekukan.

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

// Freezes the first row
sheet.setFrozenRows(1);

Parameter

NamaJenisDeskripsi
rowsIntegerJumlah baris yang akan dibekukan.

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

setHiddenGridlines(hideGridlines)

Menyembunyikan atau menampilkan garis petak sheet.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can us eSpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Hides the gridlines in the sheet.
sheet.setHiddenGridlines(true);

Parameter

NamaJenisDeskripsi
hideGridlinesBooleanJika true, sembunyikan garis petak dalam sheet ini; jika tidak, tampilkan garis petak.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

setName(name)

Menetapkan nama sheet.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.setName("not first anymore");

Parameter

NamaJenisDeskripsi
nameStringNama baru untuk sheet.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

setRightToLeft(rightToLeft)

Menyetel atau membatalkan penetapan tata letak sheet dari kanan ke kiri.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets a sheet by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets the sheet layout, so that the sheet is ordered from right to left.
sheet.setRightToLeft(true);

Parameter

NamaJenisDeskripsi
rightToLeftBooleanJika true, tata letak sheet akan disetel dari kanan ke kiri, dengan sel A1 berada di sudut kanan atas. Jika false, tata letak sheet akan disetel ke default kiri-ke-kanan, dengan sel A1 di kiri atas.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

setRowGroupControlPosition(position)

Menetapkan posisi tombol kontrol grup baris pada sheet.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setRowGroupControlPosition(SpreadsheetApp.GroupControlTogglePosition.AFTER);

Parameter

NamaJenisDeskripsi
positionGroupControlTogglePositionPosisi tombol kontrol grup baris.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

setRowHeight(rowPosition, height)

Menetapkan tinggi baris untuk baris tertentu dalam piksel. Secara default, baris membesar agar pas dengan konten sel. Jika Anda ingin memaksa baris ke tinggi yang ditentukan, gunakan setRowHeightsForced(startRow, numRows, height).

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

// Sets the first row to a height of 200 pixels
sheet.setRowHeight(1, 200);

Parameter

NamaJenisDeskripsi
rowPositionIntegerPosisi baris yang akan diubah.
heightIntegerTinggi dalam piksel yang disetel.

Return

Sheet — Sheet, berguna untuk perantaian metode.

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

setRowHeights(startRow, numRows, height)

Menetapkan tinggi baris tertentu dalam piksel. Secara default, baris membesar agar pas dengan konten sel. Jika Anda ingin memaksa baris ke tinggi yang ditentukan, gunakan setRowHeightsForced(startRow, numRows, height).

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

// Sets the first three rows to a height of 20 pixels
sheet.setRowHeights(1, 3, 20);

Parameter

NamaJenisDeskripsi
startRowIntegerPosisi baris awal yang akan diubah.
numRowsIntegerJumlah baris yang akan diubah.
heightIntegerTinggi dalam piksel yang disetel.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

setRowHeightsForced(startRow, numRows, height)

Menetapkan tinggi baris tertentu dalam piksel. Secara default, baris membesar agar pas dengan konten sel. Saat Anda menggunakan setRowHeightsForced, baris dipaksa ke tinggi yang ditentukan meskipun isi sel lebih tinggi dari tinggi baris.

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

// Sets the first three rows to a height of 5 pixels.
sheet.setRowHeightsForced(1, 3, 5);

Parameter

NamaJenisDeskripsi
startRowIntegerPosisi baris awal yang akan diubah.
numRowsIntegerJumlah baris yang akan diubah.
heightIntegerTinggi dalam piksel yang disetel.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

setTabColor(color)

Menetapkan warna tab sheet.

// This example assumes there is a sheet named "first"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("first");
first.setTabColor("ff0000"); // Set the color to red.
first.setTabColor(null); // Unset the color.

Parameter

NamaJenisDeskripsi
colorStringKode warna dalam notasi CSS (seperti '#ffffff' atau 'white'), atau null untuk mereset warna tab.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

setTabColorObject(color)

Menetapkan warna tab sheet.

// This example assumes there is a sheet named "Sheet1"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var first = ss.getSheetByName("Sheet1");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
first.setTabColorObject(color); // Set the color to theme accent 1.
first.setTabColorObject(null); // Unset the color.

Parameter

NamaJenisDeskripsi
colorColorWarna tab sheet yang akan ditetapkan.

Return

Sheet — Sheet ini, untuk membuat rantai.

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

showColumns(columnIndex)

Memperlihatkan kolom pada indeks yang diberikan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Unhides the first column
sheet.showColumns(1);

Parameter

NamaJenisDeskripsi
columnIndexIntegerIndeks kolom yang akan diperlihatkan.

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

showColumns(columnIndex, numColumns)

Memperlihatkan satu atau beberapa kolom berurutan yang dimulai pada indeks yang diberikan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Unhides the first three columns
sheet.showColumns(1, 3);

Parameter

NamaJenisDeskripsi
columnIndexIntegerIndeks awal kolom yang akan diperlihatkan.
numColumnsIntegerJumlah kolom yang akan diperlihatkan.

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

showRows(rowIndex)

Memperlihatkan baris pada indeks yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Unhides the first row
sheet.showRows(1);

Parameter

NamaJenisDeskripsi
rowIndexIntegerIndeks baris yang akan diperlihatkan.

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

showRows(rowIndex, numRows)

Memperlihatkan satu atau beberapa baris berturut-turut yang dimulai pada indeks yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Unhides the first three rows
sheet.showRows(1, 3);

Parameter

NamaJenisDeskripsi
rowIndexIntegerIndeks awal baris yang akan diperlihatkan.
numRowsIntegerJumlah baris yang akan diperlihatkan.

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

showSheet()

Membuat sheet terlihat. Tidak berpengaruh jika sheet sudah terlihat.

var sheet = SpreadsheetApp.getActiveSheet();
sheet.showSheet();

Return

Sheet — Sheet saat 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

sort(columnPosition)

Mengurutkan sheet berdasarkan kolom, secara menaik.

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

// Sorts the sheet by the first column, ascending
sheet.sort(1);

Parameter

NamaJenisDeskripsi
columnPositionIntegerKolom yang akan diurutkan.

Return

Sheet — sheet, berguna untuk perantaian metode

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(columnPosition, ascending)

Mengurutkan lembar berdasarkan kolom. Dibutuhkan parameter untuk menentukan menaik atau menurun.

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

// Sorts the sheet by the first column, descending
sheet.sort(1, false);

Parameter

NamaJenisDeskripsi
columnPositionIntegerKolom yang akan diurutkan.
ascendingBooleantrue untuk urutan menaik, false untuk menurun.

Return

Sheet — sheet, berguna untuk perantaian metode

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

unhideColumn(column)

Memperlihatkan kolom dalam rentang yang diberikan.

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

// This unhides the first column if it was previously hidden
var range = sheet.getRange("A1");
sheet.unhideColumn(range);

Parameter

NamaJenisDeskripsi
columnRangeRentang yang akan diperlihatkan, jika disembunyikan.

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

unhideRow(row)

Memperlihatkan baris dalam rentang yang ditentukan.

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

// This unhides the first row if it was previously hidden
var range = sheet.getRange("A1");
sheet.unhideRow(range);

Parameter

NamaJenisDeskripsi
rowRangeRentang yang akan diperlihatkan, jika disembunyikan.

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

updateChart(chart)

Memperbarui diagram pada sheet ini.

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

// This code is going to loop through all the charts and change them to
// column charts
var charts = sheet.getCharts();
for (var i in charts) {
  var chart = charts[i];
  var newChart = chart
      .modify()
      .setChartType(Charts.ChartType.COLUMN)
      .build();
  sheet.updateChart(newChart);
}

Parameter

NamaJenisDeskripsi
chartEmbeddedChartDiagram yang akan diperbarui.

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