Class Spreadsheet

Spreadsheet

Mengakses dan mengubah file Google Spreadsheet. Operasi yang umum adalah menambahkan {i>sheet<i} baru dan menambahkan para kolaborator.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
addDeveloperMetadata(key)SpreadsheetMenambahkan metadata developer dengan kunci yang ditentukan ke spreadsheet level teratas.
addDeveloperMetadata(key, visibility)SpreadsheetMenambahkan metadata developer dengan kunci dan visibilitas yang ditentukan ke spreadsheet.
addDeveloperMetadata(key, value)SpreadsheetMenambahkan metadata developer dengan kunci dan nilai yang ditentukan ke spreadsheet.
addDeveloperMetadata(key, value, visibility)SpreadsheetMenambahkan metadata developer dengan kunci, nilai, dan visibilitas yang ditentukan ke spreadsheet.
addEditor(emailAddress)SpreadsheetMenambahkan pengguna tertentu ke daftar editor untuk Spreadsheet.
addEditor(user)SpreadsheetMenambahkan pengguna tertentu ke daftar editor untuk Spreadsheet.
addEditors(emailAddresses)SpreadsheetMenambahkan array pengguna yang diberikan ke daftar editor untuk Spreadsheet.
addMenu(name, subMenus)voidMembuat menu baru di UI Spreadsheet.
addViewer(emailAddress)SpreadsheetMenambahkan pengguna tertentu ke daftar pelihat untuk Spreadsheet.
addViewer(user)SpreadsheetMenambahkan pengguna tertentu ke daftar pelihat untuk Spreadsheet.
addViewers(emailAddresses)SpreadsheetMenambahkan array pengguna yang diberikan ke daftar pelihat untuk Spreadsheet.
appendRow(rowContents)SheetMenambahkan baris ke bagian bawah region data saat ini di sheet.
autoResizeColumn(columnPosition)SheetMenetapkan lebar kolom yang diberikan agar pas dengan kontennya.
copy(name)SpreadsheetMenyalin {i>spreadsheet<i} dan menampilkan yang baru.
createDeveloperMetadataFinder()DeveloperMetadataFinderMenampilkan DeveloperMetadataFinder untuk menemukan metadata developer dalam cakupan {i>spreadsheet <i}ini.
createTextFinder(findText)TextFinderMembuat pencari teks untuk {i>spreadsheet<i}, yang dapat digunakan untuk menemukan dan mengganti teks di dalam di {i>spreadsheet<i}.
deleteActiveSheet()SheetMenghapus sheet yang sedang aktif.
deleteColumn(columnPosition)SheetMenghapus kolom pada posisi kolom yang ditentukan.
deleteColumns(columnPosition, howMany)voidMenghapus sejumlah kolom yang dimulai dari posisi kolom yang ditentukan.
deleteRow(rowPosition)SheetMenghapus baris pada posisi baris tertentu.
deleteRows(rowPosition, howMany)voidMenghapus sejumlah baris yang dimulai dari posisi baris yang ditentukan.
deleteSheet(sheet)voidMenghapus sheet yang ditentukan.
duplicateActiveSheet()SheetMenduplikasi sheet aktif dan menjadikannya sheet aktif.
getActiveCell()RangeMenampilkan sel aktif dalam sheet ini.
getActiveRange()RangeMenampilkan rentang yang dipilih dalam sheet aktif, atau null jika tidak ada rentang yang aktif.
getActiveRangeList()RangeListMenampilkan daftar rentang aktif dalam sheet aktif atau null jika tidak ada yang aktif rentang.
getActiveSheet()SheetMendapatkan sheet aktif dalam spreadsheet.
getAs(contentType)BlobMenampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan.
getBandings()Banding[]Menampilkan semua garis berwarna di spreadsheet ini.
getBlob()BlobMenampilkan data di dalam objek ini sebagai blob.
getColumnWidth(columnPosition)IntegerMendapatkan lebar dalam piksel dari kolom yang ditentukan.
getCurrentCell()RangeMenampilkan sel saat ini dalam sheet yang aktif, atau null jika tidak ada sel saat ini.
getDataRange()RangeMenampilkan Range yang sesuai dengan dimensi tempat data tersedia.
getDataSourceFormulas()DataSourceFormula[]Mendapatkan semua formula sumber data.
getDataSourcePivotTables()DataSourcePivotTable[]Mendapatkan semua tabel pivot sumber data.
getDataSourceRefreshSchedules()DataSourceRefreshSchedule[]Mendapatkan jadwal pembaruan spreadsheet ini.
getDataSourceSheets()DataSourceSheet[]Menampilkan semua sheet sumber data dalam spreadsheet.
getDataSourceTables()DataSourceTable[]Mendapatkan semua tabel sumber data.
getDataSources()DataSource[]Menampilkan semua sumber data di spreadsheet.
getDeveloperMetadata()DeveloperMetadata[]Mendapatkan metadata developer yang terkait dengan spreadsheet tingkat atas.
getEditors()User[]Mendapatkan daftar editor untuk Spreadsheet ini.
getFormUrl()StringMenampilkan URL untuk formulir yang mengirimkan responsnya ke spreadsheet ini, atau null jika spreadsheet ini tidak memiliki formulir terkait.
getFrozenColumns()IntegerMenampilkan jumlah kolom yang dibekukan.
getFrozenRows()IntegerMenampilkan jumlah baris yang dibekukan.
getId()StringMendapatkan ID unik untuk spreadsheet ini.
getImages()OverGridImage[]Menampilkan semua gambar di atas petak pada sheet.
getIterativeCalculationConvergenceThreshold()NumberMenampilkan nilai minimum yang digunakan selama penghitungan berulang.
getLastColumn()IntegerMenampilkan posisi kolom terakhir yang memiliki konten.
getLastRow()IntegerMenampilkan posisi baris terakhir yang memiliki konten.
getMaxIterativeCalculationCycles()IntegerMenampilkan jumlah iterasi maksimum yang akan digunakan selama penghitungan berulang.
getName()StringMendapatkan nama dokumen.
getNamedRanges()NamedRange[]Mendapatkan semua rentang bernama dalam spreadsheet ini.
getNumSheets()IntegerMenampilkan jumlah sheet dalam spreadsheet ini.
getOwner()UserMenampilkan pemilik dokumen, atau null untuk dokumen di drive bersama.
getPredefinedSpreadsheetThemes()SpreadsheetTheme[]Menampilkan daftar tema yang telah ditentukan sebelumnya.
getProtections(type)Protection[]Mendapatkan array objek yang mewakili semua rentang atau sheet dilindungi dalam spreadsheet.
getRange(a1Notation)RangeMenampilkan rentang sebagaimana ditentukan dalam notasi A1 atau notasi R1C1.
getRangeByName(name)RangeMenampilkan rentang bernama, atau null jika tidak ditemukan rentang dengan nama yang diberikan.
getRangeList(a1Notations)RangeListMenampilkan koleksi RangeList yang mewakili rentang dalam sheet yang sama yang ditentukan dengan daftar notasi A1 atau notasi R1C1 yang tidak kosong.
getRecalculationInterval()RecalculationIntervalMenampilkan interval kalkulasi untuk spreadsheet ini.
getRowHeight(rowPosition)IntegerMendapatkan tinggi dalam piksel dari baris yang ditentukan.
getSelection()SelectionMenampilkan Selection saat ini dalam spreadsheet.
getSheetByName(name)SheetMenampilkan sheet dengan nama yang diberikan.
getSheetId()IntegerMenampilkan ID sheet yang diwakili oleh objek ini.
getSheetName()StringMenampilkan nama sheet.
getSheetValues(startRow, startColumn, numRows, numColumns)Object[][]Menampilkan petak nilai persegi panjang untuk rentang ini, yang dimulai dari koordinat yang diberikan.
getSheets()Sheet[]Mengambil semua sheet dalam spreadsheet ini.
getSpreadsheetLocale()StringMendapatkan lokalitas spreadsheet.
getSpreadsheetTheme()SpreadsheetThemeMenampilkan tema spreadsheet saat ini, atau null jika tidak ada tema yang diterapkan.
getSpreadsheetTimeZone()StringMendapatkan zona waktu untuk spreadsheet.
getUrl()StringMenampilkan URL untuk spreadsheet yang ditentukan.
getViewers()User[]Mendapatkan daftar pelihat dan pengomentar untuk Spreadsheet ini.
hideColumn(column)voidMenyembunyikan satu atau beberapa kolom dalam rentang yang ditentukan.
hideRow(row)voidMenyembunyikan baris dalam rentang yang ditentukan.
insertColumnAfter(afterPosition)SheetMenyisipkan kolom setelah posisi kolom yang ditentukan.
insertColumnBefore(beforePosition)SheetMenyisipkan kolom sebelum posisi kolom yang ditentukan.
insertColumnsAfter(afterPosition, howMany)SheetMenyisipkan sejumlah kolom tertentu setelah posisi kolom yang ditentukan.
insertColumnsBefore(beforePosition, howMany)SheetMenyisipkan sejumlah kolom sebelum posisi kolom yang ditentukan.
insertDataSourceSheet(spec)DataSourceSheetMenyisipkan DataSourceSheet baru di spreadsheet dan memulai eksekusi data.
insertImage(blobSource, column, row)OverGridImageMenyisipkan Spreadsheet sebagai gambar dalam dokumen pada baris dan kolom tertentu.
insertImage(blobSource, column, row, offsetX, offsetY)OverGridImageMenyisipkan Spreadsheet 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.
insertRowsAfter(afterPosition, howMany)SheetMenyisipkan sejumlah baris setelah posisi baris yang ditentukan.
insertRowsBefore(beforePosition, howMany)SheetMenyisipkan sejumlah baris sebelum posisi baris yang ditentukan.
insertSheet()SheetMenyisipkan lembar baru ke dalam {i>spreadsheet<i}, menggunakan nama {i>sheet<i} default.
insertSheet(sheetIndex)SheetMenyisipkan sheet baru ke dalam spreadsheet pada indeks tertentu.
insertSheet(sheetIndex, options)SheetMenyisipkan sheet baru ke dalam spreadsheet pada indeks yang diberikan dan menggunakan opsi lanjutan argumen.
insertSheet(options)SheetMenyisipkan sheet baru ke dalam spreadsheet, menggunakan nama sheet default dan opsi lanjutan argumen.
insertSheet(sheetName)SheetMenyisipkan sheet baru ke dalam spreadsheet dengan nama tertentu.
insertSheet(sheetName, sheetIndex)SheetMenyisipkan lembar baru ke dalam {i>spreadsheet<i} dengan nama yang diberikan pada indeks yang diberikan.
insertSheet(sheetName, sheetIndex, options)SheetMenyisipkan lembar baru ke dalam {i>spreadsheet<i} dengan nama yang diberikan pada indeks yang diberikan dan menggunakan argumen lanjutan opsional.
insertSheet(sheetName, options)SheetMenyisipkan sheet baru ke dalam spreadsheet dengan nama tertentu dan menggunakan opsi lanjutan argumen.
insertSheetWithDataSourceTable(spec)SheetMenyisipkan sheet baru dalam spreadsheet, membuat DataSourceTable yang mencakup keseluruhan {i>sheet<i} dengan spesifikasi sumber data yang diberikan, dan memulai eksekusi data.
isColumnHiddenByUser(columnPosition)BooleanMenampilkan apakah kolom yang ditentukan disembunyikan oleh pengguna.
isIterativeCalculationEnabled()BooleanMenampilkan apakah penghitungan berulang diaktifkan di spreadsheet ini.
isRowHiddenByFilter(rowPosition)BooleanMenampilkan apakah baris yang ditentukan disembunyikan oleh filter (bukan tampilan filter).
isRowHiddenByUser(rowPosition)BooleanMenampilkan apakah baris yang ditentukan disembunyikan oleh pengguna.
moveActiveSheet(pos)voidMemindahkan sheet aktif ke posisi yang ditentukan dalam daftar sheet.
moveChartToObjectSheet(chart)SheetMembuat sheet SheetType.OBJECT baru dan memindahkan diagram yang disediakan ke sheet tersebut.
refreshAllDataSources()voidMemuat ulang semua sumber data yang didukung dan objek sumber data tertaut, serta melewati nilai yang tidak valid objek sumber data.
removeEditor(emailAddress)SpreadsheetMenghapus pengguna tertentu dari daftar editor untuk Spreadsheet.
removeEditor(user)SpreadsheetMenghapus pengguna tertentu dari daftar editor untuk Spreadsheet.
removeMenu(name)voidMenghapus menu yang ditambahkan oleh addMenu(name, subMenus).
removeNamedRange(name)voidMenghapus rentang bernama yang diberi nama.
removeViewer(emailAddress)SpreadsheetMenghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Spreadsheet.
removeViewer(user)SpreadsheetMenghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Spreadsheet.
rename(newName)voidMengganti nama dokumen.
renameActiveSheet(newName)voidMengganti nama sheet yang aktif saat ini menjadi nama baru yang diberikan.
resetSpreadsheetTheme()SpreadsheetThemeMenghapus tema yang diterapkan dan menetapkan tema default pada spreadsheet.
setActiveRange(range)RangeMenetapkan rentang yang ditentukan sebagai active range di sheet aktif, dengan sel kiri atas dalam rentang sebagai current cell.
setActiveRangeList(rangeList)RangeListMenetapkan daftar rentang yang ditentukan sebagai active ranges dalam {i>active sheet<i}.
setActiveSelection(range)RangeMenetapkan wilayah pemilihan aktif untuk sheet ini.
setActiveSelection(a1Notation)RangeMenetapkan pilihan aktif, sebagaimana ditentukan dalam notasi A1 atau notasi R1C1.
setActiveSheet(sheet)SheetMenetapkan sheet yang diberikan menjadi sheet aktif dalam spreadsheet.
setActiveSheet(sheet, restoreSelection)SheetMenetapkan sheet yang diberikan menjadi sheet aktif dalam spreadsheet, dengan opsi untuk memulihkan pilihan terbaru dalam {i>sheet<i} tersebut.
setColumnWidth(columnPosition, width)SheetMenetapkan lebar kolom yang ditentukan dalam piksel.
setCurrentCell(cell)RangeMenetapkan sel yang ditentukan sebagai current cell.
setFrozenColumns(columns)voidMembekukan sejumlah kolom yang ditentukan.
setFrozenRows(rows)voidMembekukan sejumlah baris yang ditentukan.
setIterativeCalculationConvergenceThreshold(minThreshold)SpreadsheetMenetapkan nilai minimum untuk penghitungan berulang.
setIterativeCalculationEnabled(isEnabled)SpreadsheetMenetapkan apakah penghitungan berulang diaktifkan di spreadsheet ini.
setMaxIterativeCalculationCycles(maxIterations)SpreadsheetMenetapkan jumlah maksimum iterasi penghitungan yang harus dilakukan selama iterasi kalkulasi.
setNamedRange(name, range)voidMencantumkan nama rentang.
setRecalculationInterval(recalculationInterval)SpreadsheetMenetapkan seberapa sering spreadsheet ini harus menghitung ulang.
setRowHeight(rowPosition, height)SheetMenetapkan tinggi baris untuk baris yang ditentukan dalam piksel.
setSpreadsheetLocale(locale)voidMenetapkan lokalitas spreadsheet.
setSpreadsheetTheme(theme)SpreadsheetThemeMenetapkan tema pada spreadsheet.
setSpreadsheetTimeZone(timezone)voidMenetapkan zona waktu untuk spreadsheet.
show(userInterface)voidMenampilkan komponen antarmuka pengguna kustom dalam dialog yang berpusat di browser browser area pandang.
sort(columnPosition)SheetMengurutkan sheet berdasarkan kolom, secara menaik.
sort(columnPosition, ascending)SheetMengurutkan sheet berdasarkan kolom.
toast(msg)voidMenampilkan jendela pop-up di sudut kanan bawah spreadsheet dengan pesan yang diberikan.
toast(msg, title)voidMenampilkan jendela {i>pop-up<i} di sudut kanan bawah {i>spreadsheet<i} dengan pesan yang diberikan dan title.
toast(msg, title, timeoutSeconds)voidMenampilkan jendela {i>pop-up<i} di sudut kanan bawah {i>spreadsheet<i} dengan judul yang diberikan dan pesan, yang tetap terlihat selama jangka waktu tertentu.
unhideColumn(column)voidMemperlihatkan kolom dalam rentang yang ditentukan.
unhideRow(row)voidMemperlihatkan baris dalam rentang yang ditentukan.
updateMenu(name, subMenus)voidMemperbarui menu yang ditambahkan oleh addMenu(name, subMenus).
waitForAllDataExecutionsCompletion(timeoutInSeconds)voidMenunggu sampai semua eksekusi saat ini dalam spreadsheet selesai, waktu habis setelah jumlah detik yang disediakan.

Dokumentasi mendetail

addDeveloperMetadata(key)

Menambahkan metadata developer dengan kunci yang ditentukan ke spreadsheet level teratas.

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

// Adds the key 'NAME' in the developer metadata for the spreadsheet.
ss.addDeveloperMetadata('NAME')

// Gets the first developer metadata object and logs its key.
const developerMetaData = ss.getDeveloperMetadata()[0]
console.log(developerMetaData.getKey())

Parameter

NamaJenisDeskripsi
keyStringKunci untuk metadata developer baru.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk perantaian.

Otorisasi

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

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

addDeveloperMetadata(key, visibility)

Menambahkan metadata developer dengan kunci dan visibilitas yang ditentukan ke spreadsheet.

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

// Adds the key 'NAME' in the developer metadata for the spreadsheet and sets the visibility
// to the developer project that created the metadata.
ss.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the first developer metadata object and logs its key and visibility setting.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(`Key: ${developerMetaData.getKey()},
.             Visibility: ${developerMetaData.getVisibility()}`);

Parameter

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

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk perantaian.

Otorisasi

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

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

addDeveloperMetadata(key, value)

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

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

// Adds the key 'NAME' and sets the value to 'GOOGLE' in the developer metadata for the
// spreadsheet.
ss.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the first developer metadata object and logs its key and value.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}`);

Parameter

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

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk perantaian.

Otorisasi

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

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

addDeveloperMetadata(key, value, visibility)

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

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

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to any developer project with document access.
ss.addDeveloperMetadata('NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the first developer metadata object and logs its key, value, and visibility setting.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(`Key: ${developerMetaData.getKey()},
             Value: ${developerMetaData.getValue()},
             Visibility: ${developerMetaData.getVisibility()}`);

Parameter

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

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk perantaian.

Otorisasi

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

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

addEditor(emailAddress)

Menambahkan pengguna tertentu ke daftar editor untuk Spreadsheet. Jika pengguna sudah pada daftar penonton, metode ini mempromosikan pengguna tersebut dari daftar penonton.

Parameter

NamaJenisDeskripsi
emailAddressStringAlamat email pengguna yang akan ditambahkan.

Pulang pergi

SpreadsheetSpreadsheet ini, untuk perantaian.

Otorisasi

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

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

addEditor(user)

Menambahkan pengguna tertentu ke daftar editor untuk Spreadsheet. Jika pengguna sudah pada daftar penonton, metode ini mempromosikan pengguna tersebut dari daftar penonton.

Parameter

NamaJenisDeskripsi
userUserRepresentasi pengguna yang akan ditambahkan.

Pulang pergi

SpreadsheetSpreadsheet ini, untuk perantaian.

Otorisasi

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

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

addEditors(emailAddresses)

Menambahkan array pengguna yang diberikan ke daftar editor untuk Spreadsheet. Jika salah satu pengguna sudah ada di daftar, metode ini mempromosikan mereka dari daftar penonton.

Parameter

NamaJenisDeskripsi
emailAddressesString[]Array alamat email pengguna yang akan ditambahkan.

Pulang pergi

SpreadsheetSpreadsheet ini, untuk perantaian.

Otorisasi

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

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

addMenu(name, subMenus)

Membuat menu baru di UI Spreadsheet.

Setiap entri menu menjalankan fungsi yang ditentukan pengguna. Biasanya, Anda perlu memanggilnya dari fungsi onOpen() sehingga menu akan otomatis dibuat saat spreadsheet dimuat.

// The onOpen function is executed automatically every time a Spreadsheet is loaded
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var menuEntries = [];
  // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is
  // executed.
  menuEntries.push({name: "Menu Entry 1", functionName: "function1"});
  menuEntries.push(null); // line separator
  menuEntries.push({name: "Menu Entry 2", functionName: "function2"});

  ss.addMenu("addMenuExample", menuEntries);
}

Parameter

NamaJenisDeskripsi
nameStringNama menu yang akan dibuat.
subMenusObject[]Array peta JavaScript dengan parameter name dan functionName . Anda dapat menggunakan fungsi dari library yang disertakan, seperti Library.libFunction1.

Otorisasi

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

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

addViewer(emailAddress)

Menambahkan pengguna tertentu ke daftar pelihat untuk Spreadsheet. Jika pengguna sudah pada daftar editor, metode ini tidak berpengaruh.

Parameter

NamaJenisDeskripsi
emailAddressStringAlamat email pengguna yang akan ditambahkan.

Pulang pergi

SpreadsheetSpreadsheet ini, untuk perantaian.

Otorisasi

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

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

addViewer(user)

Menambahkan pengguna tertentu ke daftar pelihat untuk Spreadsheet. Jika pengguna sudah pada daftar editor, metode ini tidak berpengaruh.

Parameter

NamaJenisDeskripsi
userUserRepresentasi pengguna yang akan ditambahkan.

Pulang pergi

SpreadsheetSpreadsheet ini, untuk perantaian.

Otorisasi

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

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

addViewers(emailAddresses)

Menambahkan array pengguna yang diberikan ke daftar pelihat untuk Spreadsheet. Jika salah satu pengguna sudah ada di daftar editor, metode ini tidak berpengaruh bagi mereka.

Parameter

NamaJenisDeskripsi
emailAddressesString[]Array alamat email pengguna yang akan ditambahkan.

Pulang pergi

SpreadsheetSpreadsheet ini, untuk perantaian.

Otorisasi

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

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

appendRow(rowContents)

Menambahkan baris ke bagian bawah region data saat ini di sheet. Jika isi sel dimulai dengan =, hal 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.

Pulang pergi

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

autoResizeColumn(columnPosition)

Menetapkan lebar kolom yang diberikan agar pas 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 yang akan diubah ukurannya.

Pulang pergi

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

copy(name)

Menyalin {i>spreadsheet<i} dan menampilkan yang baru.

// This code makes a copy of the current spreadsheet and names it appropriately
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.copy("Copy of " + ss.getName());

Parameter

NamaJenisDeskripsi
nameStringNama salinan.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk perantaian.

Otorisasi

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

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

createDeveloperMetadataFinder()

Menampilkan DeveloperMetadataFinder untuk menemukan metadata developer dalam cakupan {i>spreadsheet <i}ini. Secara {i>default<i} mempertimbangkan semua {i>metadata<i} yang terkait dengan {i>spreadsheet<i}, {i>sheet<i}, baris, dan kolom.

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

// Adds developer metadata to the spreadsheet.
ss.addDeveloperMetadata('NAME', 'CHARLIE');
ss.addDeveloperMetadata('COMPANY', 'EXAMPLE ORGANIZATION');
ss.addDeveloperMetadata('TECHNOLOGY', 'JAVASCRIPT');

// Creates a developer metadata finder.
const developerMetadataFinder = ss.createDeveloperMetadataFinder();

// Finds the developer metadata objects with 'COMPANY' as the key.
const googleMetadataFromSpreadsheet = developerMetadataFinder.withKey('COMPANY').find();

// Gets the first result of developer metadata that has the key 'COMPANY' and logs its value.
console.log(googleMetadataFromSpreadsheet[0].getValue());

Pulang pergi

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


createTextFinder(findText)

Membuat pencari teks untuk {i>spreadsheet<i}, yang dapat digunakan untuk menemukan dan mengganti teks di dalam di {i>spreadsheet<i}. Penelusuran dimulai dari sheet pertama {i>spreadsheet<i}.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

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

// Returns the first occurrence of 'dog' in the spreadsheet.
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 akan ditelusuri.

Pulang pergi

TextFinderTextFinder untuk spreadsheet.


deleteActiveSheet()

Menghapus sheet yang sedang aktif.

// The code below deletes the currently active sheet and stores the new active sheet in a
// variable
var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();

Pulang pergi

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

deleteColumn(columnPosition)

Menghapus kolom pada posisi kolom yang ditentukan.

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.

Pulang pergi

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 dari posisi kolom yang ditentukan.

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

Pulang pergi

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 dari 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

deleteSheet(sheet)

Menghapus sheet yang ditentukan.

// The code below deletes the specified sheet.
var ss = SpreadsheetApp.getActive();
var sheet = ss.getSheetByName('My Sheet');
ss.deleteSheet(sheet);

Parameter

NamaJenisDeskripsi
sheetSheetSheet 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

duplicateActiveSheet()

Menduplikasi sheet aktif dan menjadikannya sheet aktif.

// The code below makes a duplicate of the active sheet
SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();

Pulang pergi

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

getActiveCell()

Menampilkan sel aktif dalam sheet ini.

Catatan: Sebaiknya gunakan getCurrentCell() yang menampilkan sel yang disorot.

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

Pulang pergi

Range — sel yang 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 dalam sheet aktif, atau null jika tidak ada rentang yang aktif. Jika beberapa rentang dipilih, metode ini hanya menampilkan rentang terakhir yang dipilih.

Istilah "rentang aktif" mengacu pada rentang yang telah dipilih pengguna di {i>sheet aktif<i}, tetapi dalam fungsi khusus, hal ini mengacu pada sel yang secara aktif dihitung ulang.

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

Pulang pergi

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 yang aktif rentang.

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

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

Pulang pergi

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


getActiveSheet()

Mendapatkan sheet aktif dalam spreadsheet.

Lembar aktif dalam {i>spreadsheet<i} adalah lembar kerja yang sedang ditampilkan di {i>spreadsheet<i} UI.

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

Pulang pergi

Sheet — Sheet aktif di spreadsheet.


getAs(contentType)

Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. Ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, mengasumsikan bahwa bagian dari nama {i>file<i} yang mengikuti titik terakhir (jika ada) adalah bagian yang harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".

Untuk melihat kuota harian untuk konversi, lihat Kuota untuk Google Layanan. Domain Google Workspace yang baru dibuat mungkin tunduk kepada aturan yang lebih ketat kuota tambahan.

Parameter

NamaJenisDeskripsi
contentTypeStringJenis MIME yang menjadi tujuan konversi. Untuk sebagian besar blob, 'application/pdf' adalah satu-satunya opsi yang valid. Untuk gambar dalam format BMP, GIF, JPEG, atau PNG, dari 'image/bmp', 'image/gif', 'image/jpeg', atau 'image/png' juga valid. Untuk dokumen Google Dokumen, 'text/markdown' juga valid.

Pulang pergi

Blob — Data sebagai blob.


getBandings()

Menampilkan semua garis berwarna di spreadsheet ini.

// 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 an array of the bandings in the spreadsheet.
const bandings = ss.getBandings();

// Logs the range of the first banding in the spreadsheet to the console.
console.log(bandings[0].getRange().getA1Notation());

Pulang pergi

Banding[] — Kartu garis di spreadsheet 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

getBlob()

Menampilkan data di dalam objek ini sebagai blob.

Pulang pergi

Blob — Data sebagai blob.


getColumnWidth(columnPosition)

Mendapatkan lebar dalam piksel dari kolom yang ditentukan.

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.

Pulang pergi

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

getCurrentCell()

Menampilkan sel saat ini dalam sheet yang aktif, atau null jika tidak ada sel saat ini. Tujuan sel saat ini adalah sel yang memiliki fokus di UI Google Sheets, dan ditandai dengan warna gelap {i>border<i}. Tidak pernah ada lebih dari satu sel saat ini. Saat pengguna memilih satu atau lebih rentang sel, salah satu sel yang Anda pilih adalah sel yang sedang dipilih.

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

Pulang pergi

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 tempat data tersedia.

Secara fungsional, ini sama seperti 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);
}

Pulang pergi

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

Pulang pergi

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

Pulang pergi

DataSourcePivotTable[] — Daftar tabel pivot sumber data.

Otorisasi

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

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

getDataSourceRefreshSchedules()

Mendapatkan jadwal pembaruan spreadsheet 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');

// Activates BigQuery operations for the connected spreadsheet.
SpreadsheetApp.enableBigQueryExecution();

// Gets the frequency type of the first referesh schedule in the array.
const frequencyType = ss.getDataSourceRefreshSchedules()[0]
                        .getFrequency()
                        .getFrequencyType()
                        .toString();

// Logs the frequency type to the console.
console.log(frequencyType);

Pulang pergi

DataSourceRefreshSchedule[] — Jadwal pembaruan spreadsheet 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

getDataSourceSheets()

Menampilkan semua sheet sumber data dalam spreadsheet.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// 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 the first data source sheet in the spreadsheet.
const dataSource = ss.getDataSourceSheets()[0];

// Gets the name of the data source sheet.
console.log(dataSource.asSheet().getName());

Pulang pergi

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

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

Pulang pergi

DataSourceTable[] — Daftar tabel sumber data.

Otorisasi

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

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

getDataSources()

Menampilkan semua sumber data di spreadsheet.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// 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 the data sources on the spreadsheet.
const dataSources = ss.getDataSources();

// Logs the name of the first column on the first data source.
console.log(dataSources[0].getColumns()[0].getName());

Pulang pergi

DataSource[] — Array semua 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()

Mendapatkan metadata developer yang terkait dengan spreadsheet tingkat atas.

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

// Adds 'Google' as a key to the spreadsheet metadata.
ss.addDeveloperMetadata('Google');

// Gets the spreadsheet's metadata.
const ssMetadata = ss.getDeveloperMetadata();

// Gets the first set of the spreadsheet's metadata and logs the key to the console.
console.log(ssMetadata[0].getKey());

Pulang pergi

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

Otorisasi

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

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

getEditors()

Mendapatkan daftar editor untuk Spreadsheet ini.

Pulang pergi

User[] — Array pengguna dengan izin edit.

Otorisasi

Skrip yang 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 mengirimkan responsnya ke spreadsheet ini, atau null jika spreadsheet ini tidak memiliki formulir terkait. Jika beberapa formulir mengirimkan respons ke spreadsheet ini, URL formulir yang ditampilkan tidak tentu. Sebagai alternatif, pengaitan URL per sheet dapat diambil melalui metode Sheet.getFormUrl().

// 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 the form URL from the spreadsheet.
const formUrl = ss.getFormUrl();

// Logs the form URL to the console.
console.log(formUrl);

Pulang pergi

String — URL untuk formulir yang menempatkan responsnya di spreadsheet ini, atau null jika {i>spreadsheet<i} 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());

Pulang pergi

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

Pulang pergi

Integer — jumlah baris 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

getId()

Mendapatkan ID unik untuk spreadsheet ini. ID spreadsheet dapat diekstrak dari URL-nya. Misalnya, ID spreadsheet di URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 adalah "abc1234567".

// The code below logs the ID for the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());

Pulang pergi

String — ID (atau kunci) unik untuk spreadsheet.


getImages()

Menampilkan semua gambar di atas 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());
}

Pulang pergi

OverGridImage[] — Array gambar di atas 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

getIterativeCalculationConvergenceThreshold()

Menampilkan nilai minimum yang digunakan selama penghitungan berulang. Ketika hasil berturut-turut berbeda kurang dari nilai ini, penghitungan berulang akan berhenti.

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

// Sets the iterative calculation convergence threshold for the spreadsheet.
ss.setIterativeCalculationConvergenceThreshold(2);

// Logs the threshold to the console.
console.log(ss.getIterativeCalculationConvergenceThreshold());

Pulang pergi

Number — Nilai minimum konvergensi.

Otorisasi

Skrip yang 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());

Pulang pergi

Integer — kolom 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

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

Pulang pergi

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

getMaxIterativeCalculationCycles()

Menampilkan jumlah iterasi maksimum yang akan digunakan selama penghitungan berulang.

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

// Sets the max iterative calculation cycles for the spreadsheet.
ss.setMaxIterativeCalculationCycles(10);

// Logs the max iterative calculation cycles to the console.
console.log(ss.getMaxIterativeCalculationCycles());

Pulang pergi

Integer — Jumlah maksimum iterasi penghitungan.

Otorisasi

Skrip yang 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()

Mendapatkan nama dokumen.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getName());

Pulang pergi

String — Nama 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

getNamedRanges()

Mendapatkan semua rentang bernama dalam spreadsheet ini.

// The code below logs the name of the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
  Logger.log(namedRanges[i].getName());
}

Pulang pergi

NamedRange[] — Array semua rentang bernama 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

getNumSheets()

Menampilkan jumlah sheet dalam spreadsheet ini.

// The code below logs the number of sheets in the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());

Pulang pergi

Integer — Jumlah sheet dalam spreadsheet.


getOwner()

Menampilkan pemilik dokumen, atau null untuk dokumen di drive bersama.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var owner = ss.getOwner();
Logger.log(owner.getEmail());

Pulang pergi

User — Pemilik dokumen, atau null jika dokumen berada di drive bersama.

Otorisasi

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

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

getPredefinedSpreadsheetThemes()

Menampilkan daftar tema yang telah ditentukan sebelumnya.

// The code below returns the list of predefined themes.
var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet()
                               .getPredefinedSpreadsheetThemes();

Pulang pergi

SpreadsheetTheme[] — Daftar tema yang telah 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

getProtections(type)

Mendapatkan array objek yang mewakili semua rentang atau sheet dilindungi dalam spreadsheet.

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

Parameter

NamaJenisDeskripsi
typeProtectionTypeJenis kawasan lindung, SpreadsheetApp.ProtectionType.RANGE atau SpreadsheetApp.ProtectionType.SHEET.

Pulang pergi

Protection[] — Array objek yang mewakili semua rentang atau sheet dilindungi 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

getRange(a1Notation)

Menampilkan rentang sebagaimana 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 dikembalikan, sebagaimana ditentukan dalam notasi A1 atau notasi R1C1.

Pulang pergi

Range — rentang di lokasi 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

getRangeByName(name)

Menampilkan rentang bernama, atau null jika tidak ditemukan rentang dengan nama yang diberikan. Jika lebih dari satu {i>sheet<i} {i>spreadsheet<i} menggunakan nama rentang yang sama, tentukan nama {i>sheet<i} tanpa tambahan tanda kutip — misalnya, getRangeByName('TaxRates') atau getRangeByName('Sheet Name!TaxRates'), tetapi bukan getRangeByName('"Sheet Name"!TaxRates').

// Log the number of columns for the range named 'TaxRates' in the active spreadsheet.
var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates');
if (range != null) {
  Logger.log(range.getNumColumns());
}

Parameter

NamaJenisDeskripsi
nameStringNama rentang yang akan didapatkan.

Pulang pergi

Range — Rentang sel dengan nama tertentu.


getRangeList(a1Notations)

Menampilkan koleksi RangeList yang mewakili rentang dalam sheet yang sama yang ditentukan dengan 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, sebagaimana ditentukan dalam notasi A1 atau notasi R1C1.

Pulang pergi

RangeList — daftar rentang di lokasi 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

getRecalculationInterval()

Menampilkan interval kalkulasi untuk spreadsheet ini.

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

// Logs the calculation interval for the spreadsheet to the console.
console.log(ss.getRecalculationInterval().toString());

Pulang pergi

RecalculationInterval — Interval penghitungan untuk spreadsheet 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

getRowHeight(rowPosition)

Mendapatkan tinggi dalam piksel dari baris yang ditentukan.

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.

Pulang pergi

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 dalam spreadsheet.

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

Pulang pergi

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

getSheetByName(name)

Menampilkan sheet dengan nama yang diberikan.

Jika beberapa sheet memiliki nama yang sama, sheet yang paling kiri akan ditampilkan. Menampilkan null jika tidak ada {i>sheet<i} dengan nama yang diberikan.

// The code below logs the index of a sheet named "Expenses"
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses");
if (sheet != null) {
  Logger.log(sheet.getIndex());
}

Parameter

NamaJenisDeskripsi
nameStringNama sheet yang akan didapatkan.

Pulang pergi

Sheet — Sheet dengan nama tertentu.


getSheetId()

Menampilkan ID sheet yang diwakili oleh objek ini.

ID ini adalah ID unik untuk {i>spreadsheet<i}. ID ini bersifat monoton meningkatkan integer yang ditetapkan pada waktu pembuatan sheet yang tidak bergantung pada posisi sheet. 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());

Pulang pergi

Integer — ID untuk sheet yang unik untuk 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());

Pulang pergi

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 petak nilai persegi panjang untuk rentang ini, yang dimulai dari koordinat yang diberikan. J-1 nilai yang diberikan sebagai posisi baris atau kolom sama dengan mendapatkan baris atau kolom terakhir yang memiliki data dalam {i>sheet<i}.

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.

Pulang pergi

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

getSheets()

Mengambil semua sheet dalam spreadsheet ini.

// The code below logs the name of the second sheet
var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
if (sheets.length > 1) {
  Logger.log(sheets[1].getName());
}

Pulang pergi

Sheet[] — Array dari semua sheet dalam spreadsheet.


getSpreadsheetLocale()

Mendapatkan lokalitas spreadsheet.

// 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 the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

Pulang pergi

String — Lokal 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

getSpreadsheetTheme()

Menampilkan tema spreadsheet saat ini, atau null jika tidak ada tema yang diterapkan.

// The code below returns the current theme of the spreadsheet.
var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();

Pulang pergi

SpreadsheetTheme — Tema yang diterapkan 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

getSpreadsheetTimeZone()

Mendapatkan zona waktu untuk spreadsheet.

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

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

Pulang pergi

String — Zona waktu, ditentukan dalam "panjang" (misalnya, "America/New_York", seperti yang tercantum oleh Joda.org).

Otorisasi

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

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

getUrl()

Menampilkan URL untuk spreadsheet yang ditentukan.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getUrl());

Pulang pergi

String — URL untuk spreadsheet 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

getViewers()

Mendapatkan daftar pelihat dan pengomentar untuk Spreadsheet ini.

Pulang pergi

User[] — Array pengguna dengan izin lihat atau komentar.

Otorisasi

Skrip yang 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 ditentukan.

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

hideRow(row)

Menyembunyikan baris dalam rentang yang ditentukan.

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

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.

Pulang pergi

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.

Pulang pergi

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

insertColumnsAfter(afterPosition, howMany)

Menyisipkan sejumlah 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.

Pulang pergi

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 sejumlah kolom sebelum posisi kolom yang ditentukan.

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.

Pulang pergi

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

insertDataSourceSheet(spec)

Menyisipkan DataSourceSheet baru di spreadsheet dan memulai eksekusi data. Sebagai seorang efek samping, hal ini juga membuat {i>sheet<i} baru menjadi {i>active sheet<i}.

Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Menggunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data bagi sumber data tertentu .

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

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

// Builds a data source specification.
// TODO (developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
 .asBigQuery()
 .setProjectId('project-id-1')
 .setTableProjectId('bigquery-public-data')
 .setDatasetId('ncaa_basketball')
 .setTableId('mbb_historical_teams_games')
 .build();

// Adds the data source and its data to the spreadsheet.
ss.insertDataSourceSheet(dataSourceSpec);

Parameter

NamaJenisDeskripsi
specDataSourceSpecSpesifikasi sumber data yang akan disisipkan.

Pulang pergi

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

insertImage(blobSource, column, row)

Menyisipkan Spreadsheet sebagai gambar dalam dokumen pada baris dan kolom tertentu. Gambar akan 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 (secara opsional).
columnIntegerPosisi kolom.
rowIntegerPosisi baris.

Pulang pergi

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 Spreadsheet sebagai gambar dalam dokumen pada baris dan kolom tertentu, dengan offset piksel. Ukuran gambar diambil dari konten blob. Jumlah blob maksimum yang didukung berukuran 2MB.

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

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

Parameter

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

Pulang pergi

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.

Pulang pergi

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.

Pulang pergi

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.

Pulang pergi

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 sebelum baris baru harus ditambahkan.

Pulang pergi

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

insertRowsAfter(afterPosition, howMany)

Menyisipkan sejumlah 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.

Pulang pergi

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 sejumlah 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 sebelum baris baru harus ditambahkan.
howManyIntegerJumlah baris yang akan disisipkan.

Pulang pergi

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

insertSheet()

Menyisipkan lembar baru ke dalam {i>spreadsheet<i}, menggunakan nama {i>sheet<i} default. {i>Sheet baru<i} menjadi {i>active sheet<i}.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet();

Pulang pergi

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

insertSheet(sheetIndex)

Menyisipkan sheet baru ke dalam spreadsheet pada indeks tertentu. Sheet baru akan menjadi aktif {i>sheet<i}.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet(1);

Parameter

NamaJenisDeskripsi
sheetIndexIntegerIndeks sheet yang baru dibuat. Untuk menyisipkan {i>sheet<i} sebagai yang pertama di {i>spreadsheet<i}, tetapkan ke 0.

Pulang pergi

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

insertSheet(sheetIndex, options)

Menyisipkan sheet baru ke dalam spreadsheet pada indeks yang diberikan dan menggunakan opsi lanjutan argumen. Sheet baru akan menjadi sheet aktif.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet(1, {template: templateSheet});

Parameter

NamaJenisDeskripsi
sheetIndexIntegerIndeks sheet yang baru dibuat. Untuk menyisipkan {i>sheet<i} sebagai yang pertama di {i>spreadsheet<i}, tetapkan ke 0.
optionsObjectArgumen lanjutan JavaScript opsional.

Parameter lanjutan

NamaJenisDeskripsi
templateSheetSemua data dari objek sheet template disalin ke sheet baru. Template sheet harus berupa salah satu sheet dari objek Spreadsheet.

Pulang pergi

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

insertSheet(options)

Menyisipkan sheet baru ke dalam spreadsheet, menggunakan nama sheet default dan opsi lanjutan argumen. Sheet baru akan menjadi sheet aktif.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet({template: templateSheet});

Parameter

NamaJenisDeskripsi
optionsObjectArgumen lanjutan JavaScript opsional, tercantum di bawah ini.

Parameter lanjutan

NamaJenisDeskripsi
templateSheetSemua data dari objek sheet template disalin ke sheet baru. Template sheet harus berupa salah satu sheet dari objek Spreadsheet ini.

Pulang pergi

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

insertSheet(sheetName)

Menyisipkan sheet baru ke dalam spreadsheet dengan nama tertentu. Sheet baru akan menjadi aktif {i>sheet<i}.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet');

Parameter

NamaJenisDeskripsi
sheetNameStringNama sheet baru.

Pulang pergi

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

insertSheet(sheetName, sheetIndex)

Menyisipkan lembar baru ke dalam {i>spreadsheet<i} dengan nama yang diberikan pada indeks yang diberikan. Sheet baru menjadi {i>sheet <i}aktif.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet', 1);

Parameter

NamaJenisDeskripsi
sheetNameStringNama sheet baru.
sheetIndexIntegerIndeks sheet yang baru dibuat. Untuk menyisipkan {i>sheet<i} sebagai yang pertama di {i>spreadsheet<i}, tetapkan ke 0.

Pulang pergi

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

insertSheet(sheetName, sheetIndex, options)

Menyisipkan lembar baru ke dalam {i>spreadsheet<i} dengan nama yang diberikan pada indeks yang diberikan dan menggunakan argumen lanjutan opsional. Sheet baru akan menjadi sheet aktif.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', 1, {template: templateSheet});

Parameter

NamaJenisDeskripsi
sheetNameStringNama sheet baru.
sheetIndexIntegerIndeks sheet yang baru disisipkan. Untuk menyisipkan {i>sheet<i} sebagai yang pertama di {i>spreadsheet<i}, tetapkan ke 0.
optionsObjectArgumen lanjutan JavaScript opsional.

Parameter lanjutan

NamaJenisDeskripsi
templateSheetSemua data dari objek sheet template disalin ke sheet baru. Template sheet harus berupa salah satu sheet dari objek Spreadsheet.

Pulang pergi

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

insertSheet(sheetName, options)

Menyisipkan sheet baru ke dalam spreadsheet dengan nama tertentu dan menggunakan opsi lanjutan argumen. Sheet baru akan menjadi sheet aktif.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', {template: templateSheet});

Parameter

NamaJenisDeskripsi
sheetNameStringNama sheet baru.
optionsObjectArgumen lanjutan JavaScript opsional.

Parameter lanjutan

NamaJenisDeskripsi
templateSheetSemua data dari objek sheet template disalin ke sheet baru. Template sheet harus berupa salah satu sheet dari objek Spreadsheet.

Pulang pergi

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

insertSheetWithDataSourceTable(spec)

Menyisipkan sheet baru dalam spreadsheet, membuat DataSourceTable yang mencakup keseluruhan {i>sheet<i} dengan spesifikasi sumber data yang diberikan, dan memulai eksekusi data. Sebagai sisi , menjadikan lembar baru sebagai lembar aktif.

Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Menggunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data bagi sumber data tertentu .

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

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

// Adds a sheet and sets cell A1 as the parameter cell.
const parameterCell = ss.insertSheet('parameterSheet').getRange('A1');

// Sets the value of the parameter cell to 'Duke'.
parameterCell.setValue('Duke');

const query = 'select * from `bigquery-public-data`.`ncaa_basketball`.' +
  '`mbb_historical_tournament_games` WHERE win_school_ncaa = @SCHOOL';

// Adds a data source with a query parameter.
// TODO(developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
 .asBigQuery()
 .setProjectId('project-id-1')
 .setRawQuery(query)
 .setParameterFromCell('SCHOOL', 'parameterSheet!A1')
 .build();

// Adds sheets for the data source and data source table to the spreadsheet.
ss.insertSheetWithDataSourceTable(dataSourceSpec);

Parameter

NamaJenisDeskripsi
specDataSourceSpecSpesifikasi sumber data yang akan disisipkan.

Pulang pergi

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

isColumnHiddenByUser(columnPosition)

Menampilkan apakah kolom yang ditentukan 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.

Pulang pergi

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

isIterativeCalculationEnabled()

Menampilkan apakah penghitungan berulang diaktifkan di spreadsheet ini.

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

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

Pulang pergi

Booleantrue jika penghitungan berulang diaktifkan, 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 yang ditentukan 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.

Pulang pergi

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 yang ditentukan 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.

Pulang pergi

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

moveActiveSheet(pos)

Memindahkan sheet aktif ke posisi yang ditentukan dalam daftar sheet. Menampilkan pengecualian jika posisi tersebut negatif atau lebih besar dari jumlah lembar.

// This example assumes that there are 2 sheets in the current
// active spreadsheet: one named "first" in position 1 and another named "second"
// in position 2.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// Gets the "first" sheet and activates it.
var sheet = spreadsheet.getSheetByName("first").activate();

// Logs 'Current index of sheet: 1'
console.log("Current index of sheet: %s", sheet.getIndex());

spreadsheet.moveActiveSheet(2);

// Logs 'New index of sheet: 2'
console.log("New index of sheet: %s", sheet.getIndex());

Parameter

NamaJenisDeskripsi
posIntegerPosisi 1-indeks untuk memindahkan sheet aktif dalam daftar 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

moveChartToObjectSheet(chart)

Membuat sheet SheetType.OBJECT baru dan memindahkan diagram yang disediakan ke sheet tersebut. Jika diagram sudah ada di {i>sheet<i} sendiri, {i>sheet<i} tersebut dikembalikan tanpa membuat yang baru.

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.newChart().setPosition(1, 1, 0, 0).build();
sheet.insertChart(chart);
var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);

Parameter

NamaJenisDeskripsi
chartEmbeddedChartDiagram yang akan dipindahkan.

Pulang pergi

Sheet — Sheet tempat diagram berada.

Otorisasi

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

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

refreshAllDataSources()

Memuat ulang semua sumber data yang didukung dan objek sumber data tertaut, serta melewati nilai yang tidak valid objek sumber data.

Gunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data untuk jenis sumber data tertentu.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// 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 the first data source sheet on the spreadsheet.
const dataSheet = ss.getDataSourceSheets()[0];

// Refreshes all data sources on the spreadsheet.
ss.refreshAllDataSources();

// Logs the last refreshed time of the first data source sheet.
console.log(`Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`);

Otorisasi

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

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

removeEditor(emailAddress)

Menghapus pengguna tertentu dari daftar editor untuk Spreadsheet. Metode ini tidak blokir pengguna agar tidak mengakses Spreadsheet jika mereka termasuk dalam kelas pengguna yang telah akses umum—misalnya, jika Spreadsheet dibagikan ke seluruh isi pengguna domain publik, atau jika Spreadsheet berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar pelihat.

Parameter

NamaJenisDeskripsi
emailAddressStringAlamat email pengguna yang akan dihapus.

Pulang pergi

SpreadsheetSpreadsheet ini, untuk perantaian.

Otorisasi

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

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

removeEditor(user)

Menghapus pengguna tertentu dari daftar editor untuk Spreadsheet. Metode ini tidak blokir pengguna agar tidak mengakses Spreadsheet jika mereka termasuk dalam kelas pengguna yang telah akses umum—misalnya, jika Spreadsheet dibagikan ke seluruh isi pengguna domain publik, atau jika Spreadsheet berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar pelihat.

Parameter

NamaJenisDeskripsi
userUserRepresentasi pengguna yang akan dihapus.

Pulang pergi

SpreadsheetSpreadsheet ini, untuk perantaian.

Otorisasi

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

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

removeMenu(name)

Menghapus menu yang ditambahkan oleh addMenu(name, subMenus). Argumen name harus memiliki nilai yang sama dengan panggilan yang sesuai ke addMenu(name, subMenus).

// The onOpen function is executed automatically every time a Spreadsheet is loaded
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"},
                                       {name: "foo", functionName: "foo"}]);
}
function removeBadMenu() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.removeMenu("badMenu");  // name must match the name used when added the menu
}
function foo(){
// Do nothing
}

Parameter

NamaJenisDeskripsi
nameStringNama menu 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

removeNamedRange(name)

Menghapus rentang bernama yang diberi nama. Menampilkan pengecualian jika tidak ada rentang dengan nama yang diberikan yang ditemukan di {i>spreadsheet<i}.

// The code below creates a new named range "foo", and then remove it.
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange("foo", ss.getActiveRange());
ss.removeNamedRange("foo");

Parameter

NamaJenisDeskripsi
nameStringNama rentang.

Otorisasi

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

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

removeViewer(emailAddress)

Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Spreadsheet. Ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat atau pengomentar. Metode ini juga tidak akan memblokir pengguna agar tidak mengakses Spreadsheet jika mereka termasuk dalam kelas pengguna yang memiliki akses umum—misalnya, jika Spreadsheet dibagikan ke seluruh domain, atau jika Spreadsheet berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar editor.

Parameter

NamaJenisDeskripsi
emailAddressStringAlamat email pengguna yang akan dihapus.

Pulang pergi

SpreadsheetSpreadsheet ini untuk perantaian.

Otorisasi

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

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

removeViewer(user)

Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Spreadsheet. Ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat. Metode ini juga tidak memblokir pengguna agar tidak mengakses Spreadsheet jika mereka termasuk dalam kelas pengguna yang memiliki akses—misalnya, jika Spreadsheet dibagikan ke seluruh domain pengguna, atau jika Spreadsheet berada di drive bersama yang dapat diakses pengguna.

Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar editor.

Parameter

NamaJenisDeskripsi
userUserRepresentasi pengguna yang akan dihapus.

Pulang pergi

SpreadsheetSpreadsheet ini untuk perantaian.

Otorisasi

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

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

rename(newName)

Mengganti nama dokumen.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.rename("This is the new name");

Parameter

NamaJenisDeskripsi
newNameStringNama baru untuk dokumen.

Otorisasi

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

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

renameActiveSheet(newName)

Mengganti nama sheet yang aktif saat ini menjadi nama baru yang diberikan.

// The code below renames the active sheet to "Hello world"
SpreadsheetApp.getActiveSpreadsheet().renameActiveSheet("Hello world");

Parameter

NamaJenisDeskripsi
newNameStringNama baru untuk sheet yang 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

resetSpreadsheetTheme()

Menghapus tema yang diterapkan dan menetapkan tema default pada spreadsheet.

// The code below applies default theme on the spreadsheet.
SpreadsheetApp.getActiveSpreadsheet().resetSpreadsheetTheme();

Pulang pergi

SpreadsheetTheme — Tema default.

Otorisasi

Skrip yang 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 di 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.

Pulang pergi

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 dalam {i>active sheet<i}. 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 untuk dipilih.

Pulang pergi

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 wilayah 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 yang akan ditetapkan sebagai pilihan aktif.

Pulang pergi

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 pilihan 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, sebagaimana ditentukan dalam notasi A1 atau notasi R1C1.

Pulang pergi

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

setActiveSheet(sheet)

Menetapkan sheet yang diberikan menjadi sheet aktif dalam spreadsheet. UI Google Spreadsheet akan menampilkan {i>sheet<i} yang dipilih kecuali jika {i>sheet<i} itu milik {i>spreadsheet <i}yang berbeda.

// The code below makes the first sheet active in the active spreadsheet.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
spreadsheet.setActiveSheet(spreadsheet.getSheets()[0]);

Parameter

NamaJenisDeskripsi
sheetSheetSheet yang akan ditetapkan sebagai sheet aktif.

Pulang pergi

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

setActiveSheet(sheet, restoreSelection)

Menetapkan sheet yang diberikan menjadi sheet aktif dalam spreadsheet, dengan opsi untuk memulihkan pilihan terbaru dalam {i>sheet<i} tersebut. UI Google Spreadsheet menampilkan sheet yang dipilih kecuali {i>sheet<i} itu berasal dari {i>spreadsheet <i}yang berbeda.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var firstSheet = spreadsheet.getSheets()[0];
var secondSheet = spreadsheet.getSheets()[1];
// Set the first sheet as the active sheet and select the range D4:F4.
spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate();

// Switch to the second sheet to do some work.
spreadsheet.setActiveSheet(secondSheet);
// Switch back to first sheet, and restore its selection.
spreadsheet.setActiveSheet(firstSheet, true);

// The selection of first sheet is restored, and it logs D4:F4
var range = spreadsheet.getActiveSheet().getSelection().getActiveRange();
Logger.log(range.getA1Notation());

Parameter

NamaJenisDeskripsi
sheetSheetSheet baru yang aktif.
restoreSelectionBooleanTf true, pilihan terbaru dari sheet aktif baru dipilih lagi saat sheet baru menjadi aktif; jika false, sheet baru menjadi aktif tanpa mengubah pilihan yang ada.

Pulang pergi

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

setColumnWidth(columnPosition, width)

Menetapkan lebar kolom yang ditentukan 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 akan disetel.

Pulang pergi

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

setCurrentCell(cell)

Menetapkan sel yang ditentukan sebagai current cell.

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

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

Catatan:Yang ditentukan Range harus terdiri dari satu sel, jika tidak, akan muncul pengecualian.

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.

Pulang pergi

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 sejumlah 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 sejumlah 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

setIterativeCalculationConvergenceThreshold(minThreshold)

Menetapkan nilai minimum untuk penghitungan berulang. Ketika hasil berturut-turut berbeda kurang dari nilai ini, penghitungan berulang akan berhenti. Nilai ini harus non-negatif, dan didefaultkan ke 0,05.

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

// Sets the iterative calculation convergence threshold for the spreadsheet.
ss.setIterativeCalculationConvergenceThreshold(2);

// Logs the threshold to the console.
console.log(ss.getIterativeCalculationConvergenceThreshold());

Parameter

NamaJenisDeskripsi
minThresholdNumberAmbang batas konvergensi minimum (harus positif).

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk perantaian.

Otorisasi

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

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

setIterativeCalculationEnabled(isEnabled)

Menetapkan apakah penghitungan berulang diaktifkan di spreadsheet ini. Jika jumlah maksimum siklus kalkulasi dan nilai minimum konvergensi belum ditetapkan sebelumnya ketika penghitungan diaktifkan, nilai defaultnya adalah 50 dan 0,05. Jika salah satunya telah ditetapkan sebelumnya, mempertahankan nilai sebelumnya.

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

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

Parameter

NamaJenisDeskripsi
isEnabledBooleantrue jika penghitungan berulang harus diaktifkan; false sebaliknya.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk perantaian.

Otorisasi

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

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

setMaxIterativeCalculationCycles(maxIterations)

Menetapkan jumlah maksimum iterasi penghitungan yang harus dilakukan selama iterasi kalkulasi. Nilai ini harus antara 1 dan 10.000 (inklusif), dan defaultnya adalah 50.

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

// Sets the max iterative calculation cycles for the spreadsheet.
ss.setMaxIterativeCalculationCycles(10);

// Logs the max iterative calculation cycles to the console.
console.log(ss.getMaxIterativeCalculationCycles());

Parameter

NamaJenisDeskripsi
maxIterationsIntegerJumlah maksimum iterasi penghitungan (antara 1 dan 10.000).

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk perantaian.

Otorisasi

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

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

setNamedRange(name, range)

Mencantumkan nama rentang.

// The code below creates a new named range "TaxRates" in the active spreadsheet
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange("TaxRates", SpreadsheetApp.getActiveRange());

Parameter

NamaJenisDeskripsi
nameStringNama untuk memberikan rentang.
rangeRangeSpesifikasi rentang.

Otorisasi

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

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

setRecalculationInterval(recalculationInterval)

Menetapkan seberapa sering spreadsheet ini harus menghitung ulang.

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

// Sets the  calculation interval for the spreadsheet to 'ON_CHANGE'.
const interval = ss.setRecalculationInterval(SpreadsheetApp.RecalculationInterval.ON_CHANGE);

// Logs the calculation interval to the console.
console.log(interval);

Parameter

NamaJenisDeskripsi
recalculationIntervalRecalculationIntervalInterval penghitungan ulang baru.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk perantaian.

Otorisasi

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

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

setRowHeight(rowPosition, height)

Menetapkan tinggi baris untuk baris yang ditentukan dalam piksel. Secara default, baris membesar sesuai dengan isi sel. Jika Anda ingin memaksa baris ke tinggi yang ditentukan, gunakan Sheet.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 {i>pixel<i} untuk menyetelnya.

Pulang pergi

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

setSpreadsheetLocale(locale)

Menetapkan lokalitas spreadsheet.

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

// Sets the spreadsheet locale.
ss.setSpreadsheetLocale('fr');

// Gets the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

Parameter

NamaJenisDeskripsi
localeStringKode lokalitas yang akan digunakan (misalnya, 'en', 'fr', atau 'en_US').

Otorisasi

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

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

setSpreadsheetTheme(theme)

Menetapkan tema pada spreadsheet.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// The code below sets the second predefined theme as the current theme of the spreadsheet.
var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes();
spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);

Parameter

NamaJenisDeskripsi
themeSpreadsheetThemeTema yang akan diterapkan.

Pulang pergi

SpreadsheetTheme — Tema baru 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

setSpreadsheetTimeZone(timezone)

Menetapkan zona waktu untuk spreadsheet.

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

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

Parameter

NamaJenisDeskripsi
timezoneStringZona waktu, ditentukan dalam "panjang" (misalnya, "America/New_York", seperti dicantumkan oleh Joda.org).

Otorisasi

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

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

show(userInterface)

Menampilkan komponen antarmuka pengguna kustom dalam dialog yang berpusat di browser browser area pandang. Eksekusi skrip sisi server tidak ditangguhkan. Untuk berkomunikasi dengan sisi server, komponen antarmuka pengguna harus melakukan callback asinkron ke sisi server {i>script<i}.

Jika skrip sisi server sebelumnya menampilkan dialog yang belum ditutup, dialog yang ada akan diganti dengan antarmuka pengguna dialog yang baru diminta.

Cuplikan kode berikut menampilkan aplikasi HtmlService sederhana dalam dialog dengan judul, tinggi, dan lebar yang ditentukan:

var htmlApp = HtmlService
    .createHtmlOutput('<p>A change of speed, a change of style...</p>')
    .setTitle('My HtmlService Application')
    .setWidth(250)
    .setHeight(300);

SpreadsheetApp.getActiveSpreadsheet().show(htmlApp);

// The script resumes execution immediately after showing the dialog.

Parameter

NamaJenisDeskripsi
userInterfaceObjectHtmlOutput.

Otorisasi

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

  • https://www.googleapis.com/auth/script.container.ui

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.

Pulang pergi

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 sheet berdasarkan kolom. Mengambil parameter untuk menentukan urutan naik atau turun.

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 mengurutkan naik, false untuk menurun.

Pulang pergi

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

toast(msg)

Menampilkan jendela pop-up di sudut kanan bawah spreadsheet dengan pesan yang diberikan.

// Show a popup with the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started');

Parameter

NamaJenisDeskripsi
msgStringPesan yang akan ditampilkan di toast.

Otorisasi

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

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

toast(msg, title)

Menampilkan jendela {i>pop-up<i} di sudut kanan bawah {i>spreadsheet<i} dengan pesan yang diberikan dan title.

// Show a popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');

Parameter

NamaJenisDeskripsi
msgStringPesan yang akan ditampilkan di toast.
titleStringJudul opsional toast.

Otorisasi

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

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

toast(msg, title, timeoutSeconds)

Menampilkan jendela {i>pop-up<i} di sudut kanan bawah {i>spreadsheet<i} dengan judul yang diberikan dan pesan, yang tetap terlihat selama jangka waktu tertentu.

// Show a 3-second popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);

Parameter

NamaJenisDeskripsi
msgStringPesan yang akan ditampilkan di toast.
titleStringJudul opsional toast.
timeoutSecondsNumberWaktu tunggu dalam detik; jika null, toast default adalah 5 detik; jika negatif, toast akan tetap ada sampai ditutup.

Otorisasi

Skrip yang 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 ditentukan.

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

updateMenu(name, subMenus)

Memperbarui menu yang ditambahkan oleh addMenu(name, subMenus). Berfungsi persis seperti addMenu(name, subMenus).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var menuEntries = [];
menuEntries.push({name: "Lone Menu Entry", functionName: "function1"});
ss.updateMenu("addMenuExample", menuEntries);

Parameter

NamaJenisDeskripsi
nameStringNama menu yang akan diperbarui.
subMenusObject[]Array peta JavaScript dengan parameter name dan functionName . Anda dapat menggunakan fungsi dari library yang disertakan, seperti Library.libFunction1.

Otorisasi

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

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

waitForAllDataExecutionsCompletion(timeoutInSeconds)

Menunggu sampai semua eksekusi saat ini dalam spreadsheet selesai, waktu habis setelah jumlah detik yang disediakan. Menampilkan pengecualian jika eksekusi tidak selesai saat pengaturan waktu tapi tidak membatalkan eksekusi data.

Parameter

NamaJenisDeskripsi
timeoutInSecondsIntegerWaktu tunggu untuk eksekusi data, dalam detik. Maksimumnya adalah 300 detik.

Otorisasi

Skrip yang 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