Class Spreadsheet

Mengakses dan mengubah file Google Spreadsheet. Operasi umum adalah menambahkan sheet baru dan menambahkan kolaborator.

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
`addDeveloperMetadata(key)`	`Spreadsheet`	Menambahkan metadata developer dengan kunci yang ditentukan ke spreadsheet tingkat atas.
`addDeveloperMetadata(key, visibility)`	`Spreadsheet`	Menambahkan metadata developer dengan kunci dan visibilitas yang ditentukan ke spreadsheet.
`addDeveloperMetadata(key, value)`	`Spreadsheet`	Menambahkan metadata developer dengan kunci dan nilai yang ditentukan ke spreadsheet.
`addDeveloperMetadata(key, value, visibility)`	`Spreadsheet`	Menambahkan metadata developer dengan kunci, nilai, dan visibilitas yang ditentukan ke spreadsheet.
`addEditor(emailAddress)`	`Spreadsheet`	Menambahkan pengguna tertentu ke daftar editor untuk `Spreadsheet`.
`addEditor(user)`	`Spreadsheet`	Menambahkan pengguna tertentu ke daftar editor untuk `Spreadsheet`.
`addEditors(emailAddresses)`	`Spreadsheet`	Menambahkan array pengguna tertentu ke daftar editor untuk `Spreadsheet`.
`addMenu(name, subMenus)`	`void`	Membuat menu baru di UI Spreadsheet.
`addViewer(emailAddress)`	`Spreadsheet`	Menambahkan pengguna tertentu ke daftar penonton untuk `Spreadsheet`.
`addViewer(user)`	`Spreadsheet`	Menambahkan pengguna tertentu ke daftar penonton untuk `Spreadsheet`.
`addViewers(emailAddresses)`	`Spreadsheet`	Menambahkan array pengguna tertentu ke daftar penonton untuk `Spreadsheet`.
`appendRow(rowContents)`	`Sheet`	Menambahkan baris ke bagian bawah area data saat ini di sheet.
`autoResizeColumn(columnPosition)`	`Sheet`	Menyetel lebar kolom yang diberikan agar sesuai dengan kontennya.
`copy(name)`	`Spreadsheet`	Menyalin spreadsheet dan menampilkan spreadsheet baru.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Menampilkan `DeveloperMetadataFinder` untuk menemukan metadata developer dalam cakupan spreadsheet ini.
`createTextFinder(findText)`	`TextFinder`	Membuat pencari teks untuk spreadsheet, yang dapat digunakan untuk menemukan dan mengganti teks dalam spreadsheet.
`deleteActiveSheet()`	`Sheet`	Menghapus sheet yang sedang aktif.
`deleteColumn(columnPosition)`	`Sheet`	Menghapus kolom pada posisi kolom yang ditentukan.
`deleteColumns(columnPosition, howMany)`	`void`	Menghapus sejumlah kolom yang dimulai pada posisi kolom tertentu.
`deleteRow(rowPosition)`	`Sheet`	Menghapus baris pada posisi baris yang ditentukan.
`deleteRows(rowPosition, howMany)`	`void`	Menghapus sejumlah baris yang dimulai pada posisi baris tertentu.
`deleteSheet(sheet)`	`void`	Menghapus sheet yang ditentukan.
`duplicateActiveSheet()`	`Sheet`	Menduplikasi sheet aktif dan menjadikannya sheet aktif.
`getActiveCell()`	`Range`	Menampilkan sel aktif di sheet ini.
`getActiveRange()`	`Range`	Menampilkan rentang yang dipilih di sheet aktif, atau `null` jika tidak ada rentang aktif.
`getActiveRangeList()`	`RangeList\|null`	Menampilkan daftar rentang aktif di sheet aktif atau `null` jika tidak ada rentang aktif.
`getActiveSheet()`	`Sheet`	Mendapatkan sheet aktif dalam spreadsheet.
`getAs(contentType)`	`Blob`	Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan.
`getBandings()`	`Banding[]`	Menampilkan semua pengelompokan dalam spreadsheet ini.
`getBlob()`	`Blob`	Menampilkan data di dalam objek ini sebagai blob.
`getColumnWidth(columnPosition)`	`Integer`	Mendapatkan lebar dalam piksel dari kolom yang ditentukan.
`getCurrentCell()`	`Range\|null`	Menampilkan sel saat ini di sheet aktif atau `null` jika tidak ada sel saat ini.
`getDataRange()`	`Range`	Menampilkan `Range` yang sesuai dengan dimensi tempat data berada.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Mendapatkan semua formula sumber data.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Mendapatkan semua tabel pivot sumber data.
`getDataSourceRefreshSchedules()`	`DataSourceRefreshSchedule[]`	Mendapatkan jadwal refresh spreadsheet ini.
`getDataSourceSheets()`	`DataSourceSheet[]`	Menampilkan semua sheet sumber data dalam spreadsheet.
`getDataSourceTables()`	`DataSourceTable[]`	Mendapatkan semua tabel sumber data.
`getDataSources()`	`DataSource[]`	Menampilkan semua sumber data dalam spreadsheet.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Mendapatkan metadata developer yang terkait dengan spreadsheet tingkat atas.
`getEditors()`	`User[]`	Mendapatkan daftar editor untuk `Spreadsheet` ini.
`getFormUrl()`	`String`	Menampilkan URL untuk formulir yang mengirimkan responsnya ke spreadsheet ini, atau `null` jika spreadsheet ini tidak memiliki formulir terkait.
`getFrozenColumns()`	`Integer`	Menampilkan jumlah kolom yang dibekukan.
`getFrozenRows()`	`Integer`	Menampilkan jumlah baris yang dibekukan.
`getId()`	`String`	Mendapatkan ID unik untuk spreadsheet ini.
`getImages()`	`OverGridImage[]`	Menampilkan semua gambar di luar petak pada sheet.
`getIterativeCalculationConvergenceThreshold()`	`Number`	Menampilkan nilai minimum yang digunakan selama penghitungan iteratif.
`getLastColumn()`	`Integer`	Menampilkan posisi kolom terakhir yang memiliki konten.
`getLastRow()`	`Integer`	Menampilkan posisi baris terakhir yang memiliki konten.
`getMaxIterativeCalculationCycles()`	`Integer`	Menampilkan jumlah maksimum iterasi yang akan digunakan selama perhitungan iteratif.
`getName()`	`String`	Mendapatkan nama dokumen.
`getNamedRanges()`	`NamedRange[]`	Mendapatkan semua rentang bernama dalam spreadsheet ini.
`getNumSheets()`	`Integer`	Menampilkan jumlah sheet dalam spreadsheet ini.
`getOwner()`	`User`	Menampilkan pemilik dokumen, atau `null` untuk dokumen di drive bersama.
`getPredefinedSpreadsheetThemes()`	`SpreadsheetTheme[]`	Menampilkan daftar tema standar.
`getProtections(type)`	`Protection[]`	Mendapatkan array objek yang merepresentasikan semua rentang atau sheet yang dilindungi dalam spreadsheet.
`getRange(a1Notation)`	`Range`	Menampilkan rentang seperti yang ditentukan dalam notasi A1 atau notasi R1C1.
`getRangeByName(name)`	`Range`	Menampilkan rentang bernama, atau `null` jika tidak ada rentang dengan nama yang diberikan.
`getRangeList(a1Notations)`	`RangeList`	Menampilkan koleksi `RangeList` yang merepresentasikan rentang dalam sheet yang sama yang ditentukan oleh daftar notasi A1 atau notasi R1C1 yang tidak kosong.
`getRecalculationInterval()`	`RecalculationInterval`	Menampilkan interval penghitungan untuk spreadsheet ini.
`getRowHeight(rowPosition)`	`Integer`	Mendapatkan tinggi dalam piksel dari baris yang diberikan.
`getSelection()`	`Selection`	Menampilkan `Selection` saat ini dalam spreadsheet.
`getSheetById(id)`	`Sheet\|null`	Mendapatkan sheet dengan ID yang diberikan.
`getSheetByName(name)`	`Sheet\|null`	Menampilkan sheet dengan nama yang diberikan.
`getSheetId()`	`Integer`	Menampilkan ID sheet yang diwakili oleh objek ini.
`getSheetName()`	`String`	Menampilkan nama sheet.
`getSheetValues(startRow, startColumn, numRows, numColumns)`	`Object[][]`	Menampilkan petak persegi panjang nilai untuk rentang ini yang dimulai pada koordinat yang diberikan.
`getSheets()`	`Sheet[]`	Mendapatkan semua sheet dalam spreadsheet ini.
`getSpreadsheetLocale()`	`String`	Mendapatkan lokalitas spreadsheet.
`getSpreadsheetTheme()`	`SpreadsheetTheme\|null`	Menampilkan tema spreadsheet saat ini, atau `null` jika tidak ada tema yang diterapkan.
`getSpreadsheetTimeZone()`	`String`	Mendapatkan zona waktu untuk spreadsheet.
`getUrl()`	`String`	Menampilkan URL untuk spreadsheet yang diberikan.
`getViewers()`	`User[]`	Mendapatkan daftar pelihat dan pengomentar untuk `Spreadsheet` ini.
`hideColumn(column)`	`void`	Menyembunyikan kolom dalam rentang yang diberikan.
`hideRow(row)`	`void`	Menyembunyikan baris dalam rentang yang diberikan.
`insertColumnAfter(afterPosition)`	`Sheet`	Menyisipkan kolom setelah posisi kolom yang diberikan.
`insertColumnBefore(beforePosition)`	`Sheet`	Menyisipkan kolom sebelum posisi kolom yang ditentukan.
`insertColumnsAfter(afterPosition, howMany)`	`Sheet`	Menyisipkan sejumlah kolom tertentu setelah posisi kolom tertentu.
`insertColumnsBefore(beforePosition, howMany)`	`Sheet`	Menyisipkan sejumlah kolom sebelum posisi kolom yang ditentukan.
`insertDataSourceSheet(spec)`	`DataSourceSheet`	Menyisipkan `DataSourceSheet` baru dalam spreadsheet dan memulai eksekusi data.
`insertImage(blobSource, column, row)`	`OverGridImage`	Menyisipkan `Spreadsheet` sebagai gambar dalam dokumen pada baris dan kolom tertentu.
`insertImage(blobSource, column, row, offsetX, offsetY)`	`OverGridImage`	Menyisipkan `Spreadsheet` sebagai gambar dalam dokumen pada baris dan kolom tertentu, dengan offset piksel.
`insertImage(url, column, row)`	`OverGridImage`	Menyisipkan gambar dalam dokumen pada baris dan kolom tertentu.
`insertImage(url, column, row, offsetX, offsetY)`	`OverGridImage`	Menyisipkan gambar dalam dokumen pada baris dan kolom tertentu, dengan offset piksel.
`insertRowAfter(afterPosition)`	`Sheet`	Menyisipkan baris setelah posisi baris yang diberikan.
`insertRowBefore(beforePosition)`	`Sheet`	Menyisipkan baris sebelum posisi baris tertentu.
`insertRowsAfter(afterPosition, howMany)`	`Sheet`	Menyisipkan sejumlah baris setelah posisi baris yang ditentukan.
`insertRowsBefore(beforePosition, howMany)`	`Sheet`	Menyisipkan sejumlah baris sebelum posisi baris yang diberikan.
`insertSheet()`	`Sheet`	Menyisipkan sheet baru ke dalam spreadsheet, menggunakan nama sheet default.
`insertSheet(sheetIndex)`	`Sheet`	Menyisipkan sheet baru ke dalam spreadsheet pada indeks yang diberikan.
`insertSheet(sheetIndex, options)`	`Sheet`	Menyisipkan sheet baru ke dalam spreadsheet pada indeks yang diberikan dan menggunakan argumen lanjutan opsional.
`insertSheet(options)`	`Sheet`	Menyisipkan sheet baru ke dalam spreadsheet, menggunakan nama sheet default dan argumen lanjutan opsional.
`insertSheet(sheetName)`	`Sheet`	Menyisipkan sheet baru ke dalam spreadsheet dengan nama yang diberikan.
`insertSheet(sheetName, sheetIndex)`	`Sheet`	Menyisipkan sheet baru ke dalam spreadsheet dengan nama tertentu pada indeks tertentu.
`insertSheet(sheetName, sheetIndex, options)`	`Sheet`	Menyisipkan sheet baru ke dalam spreadsheet dengan nama yang diberikan pada indeks yang diberikan dan menggunakan argumen lanjutan opsional.
`insertSheet(sheetName, options)`	`Sheet`	Menyisipkan sheet baru ke dalam spreadsheet dengan nama yang diberikan dan menggunakan argumen lanjutan opsional.
`insertSheetWithDataSourceTable(spec)`	`Sheet`	Menyisipkan sheet baru dalam spreadsheet, membuat `DataSourceTable` yang mencakup seluruh sheet dengan spesifikasi sumber data yang diberikan, dan memulai eksekusi data.
`isColumnHiddenByUser(columnPosition)`	`Boolean`	Menampilkan apakah kolom tertentu disembunyikan oleh pengguna.
`isIterativeCalculationEnabled()`	`Boolean`	Menampilkan apakah penghitungan berulang diaktifkan dalam spreadsheet ini.
`isRowHiddenByFilter(rowPosition)`	`Boolean`	Menampilkan apakah baris yang diberikan disembunyikan oleh filter (bukan tampilan filter).
`isRowHiddenByUser(rowPosition)`	`Boolean`	Menampilkan apakah baris tertentu disembunyikan oleh pengguna.
`moveActiveSheet(pos)`	`void`	Memindahkan sheet aktif ke posisi yang ditentukan dalam daftar sheet.
`moveChartToObjectSheet(chart)`	`Sheet`	Membuat sheet `SheetType.OBJECT` baru dan memindahkan diagram yang diberikan ke sheet tersebut.
`refreshAllDataSources()`	`void`	Memuat ulang semua sumber data yang didukung dan objek sumber datanya yang ditautkan, dengan melewati objek sumber data yang tidak valid.
`removeEditor(emailAddress)`	`Spreadsheet`	Menghapus pengguna tertentu dari daftar editor untuk `Spreadsheet`.
`removeEditor(user)`	`Spreadsheet`	Menghapus pengguna tertentu dari daftar editor untuk `Spreadsheet`.
`removeMenu(name)`	`void`	Menghapus menu yang ditambahkan oleh `addMenu(name, subMenus)`.
`removeNamedRange(name)`	`void`	Menghapus rentang bernama dengan nama yang diberikan.
`removeViewer(emailAddress)`	`Spreadsheet`	Menghapus pengguna tertentu dari daftar penonton dan pemberi komentar untuk `Spreadsheet`.
`removeViewer(user)`	`Spreadsheet`	Menghapus pengguna tertentu dari daftar penonton dan pemberi komentar untuk `Spreadsheet`.
`rename(newName)`	`void`	Mengganti nama dokumen.
`renameActiveSheet(newName)`	`void`	Mengganti nama sheet aktif saat ini dengan nama baru yang diberikan.
`resetSpreadsheetTheme()`	`SpreadsheetTheme`	Menghapus tema yang diterapkan dan menetapkan tema default pada spreadsheet.
`setActiveRange(range)`	`Range`	Menetapkan rentang yang ditentukan sebagai `active range` di sheet aktif, dengan sel kiri atas dalam rentang sebagai `current cell`.
`setActiveRangeList(rangeList)`	`RangeList`	Menetapkan daftar rentang yang ditentukan sebagai `active ranges` di sheet aktif.
`setActiveSelection(range)`	`Range`	Menetapkan wilayah pilihan aktif untuk sheet ini.
`setActiveSelection(a1Notation)`	`Range`	Menetapkan pilihan aktif, seperti yang ditentukan dalam notasi A1 atau notasi R1C1.
`setActiveSheet(sheet)`	`Sheet`	Menetapkan sheet tertentu sebagai sheet aktif dalam spreadsheet.
`setActiveSheet(sheet, restoreSelection)`	`Sheet`	Menetapkan sheet tertentu sebagai sheet aktif dalam spreadsheet, dengan opsi untuk memulihkan pilihan terbaru dalam sheet tersebut.
`setColumnWidth(columnPosition, width)`	`Sheet`	Menetapkan lebar kolom tertentu dalam piksel.
`setCurrentCell(cell)`	`Range`	Menetapkan sel yang ditentukan sebagai `current cell`.
`setFrozenColumns(columns)`	`void`	Membekukan jumlah kolom yang ditentukan.
`setFrozenRows(rows)`	`void`	Membekukan jumlah baris yang ditentukan.
`setIterativeCalculationConvergenceThreshold(minThreshold)`	`Spreadsheet`	Menetapkan nilai minimum untuk perhitungan iteratif.
`setIterativeCalculationEnabled(isEnabled)`	`Spreadsheet`	Menetapkan apakah penghitungan berulang diaktifkan dalam spreadsheet ini.
`setMaxIterativeCalculationCycles(maxIterations)`	`Spreadsheet`	Menetapkan jumlah maksimum iterasi penghitungan yang harus dilakukan selama penghitungan iteratif.
`setNamedRange(name, range)`	`void`	Memberi nama rentang.
`setRecalculationInterval(recalculationInterval)`	`Spreadsheet`	Menetapkan seberapa sering spreadsheet ini harus menghitung ulang.
`setRowHeight(rowPosition, height)`	`Sheet`	Menetapkan tinggi baris dari baris tertentu dalam piksel.
`setSpreadsheetLocale(locale)`	`void`	Menetapkan lokalitas spreadsheet.
`setSpreadsheetTheme(theme)`	`SpreadsheetTheme`	Menetapkan tema pada spreadsheet.
`setSpreadsheetTimeZone(timezone)`	`void`	Menetapkan zona waktu untuk spreadsheet.
`show(userInterface)`	`void`	Menampilkan komponen antarmuka pengguna kustom dalam dialog yang berada di tengah area tampilan browser pengguna.
`sort(columnPosition)`	`Sheet`	Mengurutkan sheet menurut kolom, menaik.
`sort(columnPosition, ascending)`	`Sheet`	Mengurutkan sheet menurut kolom.
`toast(msg)`	`void`	Menampilkan jendela pop-up di pojok kanan bawah spreadsheet dengan pesan yang diberikan.
`toast(msg, title)`	`void`	Menampilkan jendela pop-up di pojok kanan bawah spreadsheet dengan pesan dan judul yang diberikan.
`toast(msg, title, timeoutSeconds)`	`void`	Menampilkan jendela pop-up di pojok kanan bawah spreadsheet dengan judul dan pesan yang diberikan, yang tetap terlihat selama jangka waktu tertentu.
`unhideColumn(column)`	`void`	Menampilkan kolom dalam rentang yang ditentukan.
`unhideRow(row)`	`void`	Menampilkan baris dalam rentang yang diberikan.
`updateMenu(name, subMenus)`	`void`	Memperbarui menu yang ditambahkan oleh `addMenu(name, subMenus)`.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	Menunggu hingga semua eksekusi saat ini di spreadsheet selesai, dan akan kehabisan waktu setelah jumlah detik yang diberikan.

Metode yang tidak digunakan lagi

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
`getSheetProtection()`	`PageProtection`	Menampilkan instance `PageProtection` yang menjelaskan izin untuk sheet saat ini.
`isAnonymousView()`	`Boolean`	Menunjukkan apakah dokumen mengizinkan penayangan anonim.
`isAnonymousWrite()`	`Boolean`	Menunjukkan apakah dokumen mengizinkan pengeditan dari pengguna anonim.
`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`	`void`	Menetapkan kebijakan dokumen terkait pembacaan dan penulisan anonim.
`setSheetProtection(permissions)`	`void`	Menetapkan izin untuk sheet saat ini.

Dokumentasi mendetail

`addDeveloperMetadata(key)`

Menambahkan metadata developer dengan kunci yang ditentukan ke spreadsheet tingkat atas.

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

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

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

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

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

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

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

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

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

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

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

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

Skrip yang 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 ada dalam daftar penonton, metode ini akan mempromosikan pengguna keluar dari daftar penonton.

Parameter

Nama	Jenis	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang akan ditambahkan.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

Skrip yang 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 ada dalam daftar penonton, metode ini akan mempromosikan pengguna keluar dari daftar penonton.

Parameter

Nama	Jenis	Deskripsi
`user`	`User`	Representasi pengguna yang akan ditambahkan.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

Skrip yang 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 tertentu ke daftar editor untuk Spreadsheet. Jika salah satu pengguna sudah ada dalam daftar pelihat, metode ini akan mempromosikannya keluar dari daftar pelihat.

Parameter

Nama	Jenis	Deskripsi
`emailAddresses`	`String[]`	Array alamat email pengguna yang akan ditambahkan.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

Skrip yang 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 ingin memanggilnya dari fungsi onOpen() sehingga menu dibuat secara otomatis saat spreadsheet dimuat.

// The onOpen function is executed automatically every time a Spreadsheet is
// loaded
function onOpen() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const 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

Nama	Jenis	Deskripsi
`name`	`String`	Nama menu yang akan dibuat.
`subMenus`	`Object[]`	Array peta JavaScript dengan parameter `name` dan `functionName`. Anda dapat menggunakan fungsi dari pustaka 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 penonton untuk Spreadsheet. Jika pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh.

Parameter

Nama	Jenis	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang akan ditambahkan.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

Skrip yang 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 penonton untuk Spreadsheet. Jika pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh.

Parameter

Nama	Jenis	Deskripsi
`user`	`User`	Representasi pengguna yang akan ditambahkan.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

Skrip yang 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 tertentu ke daftar penonton untuk Spreadsheet. Jika salah satu pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh bagi mereka.

Parameter

Nama	Jenis	Deskripsi
`emailAddresses`	`String[]`	Array alamat email pengguna yang akan ditambahkan.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

Skrip yang 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 area data saat ini di sheet. Jika konten sel dimulai dengan =, konten tersebut ditafsirkan sebagai formula.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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

Nama	Jenis	Deskripsi
`rowContents`	`Object[]`	Array nilai yang akan disisipkan setelah baris terakhir dalam sheet.

Pulang pergi

Sheet — Lembar, 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)`

Menyetel lebar kolom yang diberikan agar sesuai dengan kontennya.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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

Nama	Jenis	Deskripsi
`columnPosition`	`Integer`	Posisi kolom yang akan diubah ukurannya.

Pulang pergi

Sheet — Lembar, 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 spreadsheet dan menampilkan spreadsheet baru.

// This code makes a copy of the current spreadsheet and names it appropriately
const ss = SpreadsheetApp.getActiveSpreadsheet();
ss.copy(`Copy of ${ss.getName()}`);

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama salinan.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

Skrip yang 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 spreadsheet ini. Secara default, semua metadata yang terkait dengan spreadsheet, sheet, baris, dan kolom akan dipertimbangkan.

// 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 spreadsheet, yang dapat digunakan untuk menemukan dan mengganti teks dalam spreadsheet. Penelusuran dimulai dari sheet pertama spreadsheet.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

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

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

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

Parameter

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

Pulang pergi

TextFinder — TextFinder 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
const newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();

Pulang pergi

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

`deleteColumn(columnPosition)`

Menghapus kolom pada posisi kolom yang ditentukan.

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

Parameter

Nama	Jenis	Deskripsi
`columnPosition`	`Integer`	Posisi kolom, dimulai dari 1 untuk kolom pertama.

Pulang pergi

Sheet — Lembar, berguna untuk perantaian metode.

Otorisasi

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

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

`deleteColumns(columnPosition, howMany)`

Menghapus sejumlah kolom yang dimulai pada posisi kolom tertentu.

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

Parameter

Nama	Jenis	Deskripsi
`columnPosition`	`Integer`	Posisi kolom pertama yang akan dihapus.
`howMany`	`Integer`	Jumlah 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 yang ditentukan.

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

Parameter

Nama	Jenis	Deskripsi
`rowPosition`	`Integer`	Posisi baris, dimulai dari 1 untuk baris pertama.

Pulang pergi

Sheet — Lembar, berguna untuk perantaian metode.

Otorisasi

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

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

`deleteRows(rowPosition, howMany)`

Menghapus sejumlah baris yang dimulai pada posisi baris tertentu.

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

Parameter

Nama	Jenis	Deskripsi
`rowPosition`	`Integer`	Posisi baris pertama yang akan dihapus.
`howMany`	`Integer`	Jumlah 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.
const ss = SpreadsheetApp.getActive();
const sheet = ss.getSheetByName('My Sheet');
ss.deleteSheet(sheet);

Parameter

Nama	Jenis	Deskripsi
`sheet`	`Sheet`	Sheet 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 di sheet ini.

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

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

Pulang pergi

Range — Sel aktif saat ini.

Otorisasi

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

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

`getActiveRange()`

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

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

const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
const 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

setActiveRange(range)

`getActiveRangeList()`

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

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

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

Pulang pergi

RangeList|null — 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

setActiveRangeList(rangeList)

`getActiveSheet()`

Mendapatkan sheet aktif dalam spreadsheet.

Sheet aktif dalam spreadsheet adalah sheet yang ditampilkan di UI spreadsheet.

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

Pulang pergi

Sheet — Sheet aktif dalam spreadsheet.

`getAs(contentType)`

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

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

Parameter

Nama	Jenis	Deskripsi
`contentType`	`String`	Jenis MIME yang akan dikonversi. Untuk sebagian besar blob, `'application/pdf'` adalah satu-satunya opsi yang valid. Untuk gambar dalam format BMP, GIF, JPEG, atau PNG, salah satu 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 pengelompokan dalam 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[] — Pengelompokan dalam 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.

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

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

Parameter

Nama	Jenis	Deskripsi
`columnPosition`	`Integer`	Posisi 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 di sheet aktif atau null jika tidak ada sel saat ini. Sel saat ini adalah sel yang memiliki fokus di UI Google Spreadsheet, dan ditandai dengan batas gelap. Tidak pernah ada lebih dari satu sel saat ini. Saat pengguna memilih satu atau beberapa rentang sel, salah satu sel dalam pilihan adalah sel saat ini.

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

Pulang pergi

Range|null — 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 berada.

Hal ini setara secara fungsional dengan membuat Range yang dibatasi oleh A1 dan (Sheet.getLastColumn(), Sheet.getLastRow()).

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

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

// This logs the spreadsheet in CSV format with a trailing comma
for (let i = 0; i < values.length; i++) {
  let row = '';
  for (let 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 refresh 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 pemuatan ulang 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 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 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 dapat ditentukan. Sebagai alternatif, asosiasi URL formulir per sheet dapat diambil melalui metode Sheet.getFormUrl(). Menampilkan pengecualian jika pengguna tidak memiliki izin untuk mengedit 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 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 spreadsheet 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.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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 dalam 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 luar 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 iteratif. Jika hasil penghitungan berturut-turut berbeda kurang dari nilai ini, penghitungan iteratif 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.

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

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

Pulang pergi

Integer — Kolom terakhir spreadsheet 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.

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

// This logs the value in the very last cell of this sheet
const lastRow = sheet.getLastRow();
const lastColumn = sheet.getLastColumn();
const 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 maksimum iterasi yang akan digunakan selama perhitungan iteratif.

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

const 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.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
for (let 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.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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 standar.

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

Pulang pergi

SpreadsheetTheme[] — Daftar tema standar.

Otorisasi

Skrip yang 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 merepresentasikan semua rentang atau sheet yang dilindungi dalam spreadsheet.

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

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

Parameter

Nama	Jenis	Deskripsi
`type`	`ProtectionType`	Jenis kawasan lindung, `SpreadsheetApp.ProtectionType.RANGE` atau `SpreadsheetApp.ProtectionType.SHEET`.

Pulang pergi

Protection[] — Array objek yang merepresentasikan semua rentang atau sheet yang 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 seperti yang ditentukan dalam notasi A1 atau notasi R1C1.

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

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

Parameter

Nama	Jenis	Deskripsi
`a1Notation`	`String`	Rentang yang akan ditampilkan, seperti yang 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 ada rentang dengan nama yang diberikan. Jika beberapa sheet spreadsheet menggunakan nama rentang yang sama, tentukan nama sheet tanpa tanda kutip tambahan — 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.
const range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates');
if (range != null) {
  Logger.log(range.getNumColumns());
}

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama rentang yang akan didapatkan.

Pulang pergi

Range — Rentang sel dengan nama yang diberikan.

`getRangeList(a1Notations)`

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

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

Parameter

Nama	Jenis	Deskripsi
`a1Notations`	`String[]`	Daftar rentang yang akan ditampilkan, seperti yang 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 penghitungan 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 diberikan.

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

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

Parameter

Nama	Jenis	Deskripsi
`rowPosition`	`Integer`	Posisi 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.

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
const 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

`getSheetById(id)`

Mendapatkan sheet dengan ID yang diberikan. Gunakan Sheet.getSheetId().

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetById(12345);

Parameter

Nama	Jenis	Deskripsi
`id`	`Integer`	ID sheet yang akan didapatkan.

Pulang pergi

Sheet|null — Sheet dengan ID yang diberikan atau null jika tidak ada sheet yang ditemukan.

`getSheetByName(name)`

Menampilkan sheet dengan nama yang diberikan.

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

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

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama sheet yang akan didapatkan.

Pulang pergi

Sheet|null — Sheet dengan nama yang diberikan, atau null jika tidak ada sheet yang ditemukan.

`getSheetId()`

Menampilkan ID sheet yang diwakili oleh objek ini.

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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 persegi panjang nilai untuk rentang ini yang dimulai pada koordinat yang diberikan. Nilai -1 yang diberikan sebagai posisi baris atau kolom setara dengan mendapatkan baris atau kolom terakhir yang memiliki data dalam sheet.

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

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

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

Parameter

Nama	Jenis	Deskripsi
`startRow`	`Integer`	Posisi baris awal.
`startColumn`	`Integer`	Posisi kolom awal.
`numRows`	`Integer`	Jumlah baris yang akan ditampilkan nilainya.
`numColumns`	`Integer`	Jumlah kolom yang akan ditampilkan nilainya.

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

Mendapatkan semua sheet dalam spreadsheet ini.

// The code below logs the name of the second sheet
const sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
// Iterates through the sheets and logs the name and ID of each sheet.
for (const sheet of sheets) {
  Logger.log(`name: ${sheet.getName()}, ID: ${sheet.getSheetId()}`);
}

Pulang pergi

Sheet[] — Array 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 — Lokalitas 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.
const currentTheme =
    SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();

Pulang pergi

SpreadsheetTheme|null — 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 format "long" (misalnya, "America/New_York", seperti yang tercantum di 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 diberikan.

const 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 melihat atau mengomentari.

Otorisasi

Skrip yang 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 kolom dalam rentang yang diberikan.

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

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

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

Parameter

Nama	Jenis	Deskripsi
`column`	`Range`	Rentang kolom yang akan disembunyikan.

Otorisasi

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

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

`hideRow(row)`

Menyembunyikan baris dalam rentang yang diberikan.

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

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

Parameter

Nama	Jenis	Deskripsi
`row`	`Range`	Rentang 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 diberikan.

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

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

Parameter

Nama	Jenis	Deskripsi
`afterPosition`	`Integer`	Kolom setelah kolom baru harus ditambahkan.

Pulang pergi

Sheet — Lembar, 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.

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

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

Parameter

Nama	Jenis	Deskripsi
`beforePosition`	`Integer`	Kolom sebelum kolom baru harus ditambahkan.

Pulang pergi

Sheet — Lembar, 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 tertentu.

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

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

Parameter

Nama	Jenis	Deskripsi
`afterPosition`	`Integer`	Kolom setelah kolom baru harus ditambahkan.
`howMany`	`Integer`	Jumlah kolom yang akan disisipkan.

Pulang pergi

Sheet — Lembar, 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.

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

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

Parameter

Nama	Jenis	Deskripsi
`beforePosition`	`Integer`	Kolom sebelum kolom baru harus ditambahkan.
`howMany`	`Integer`	Jumlah kolom yang akan disisipkan.

Pulang pergi

Sheet — Lembar, 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 dalam spreadsheet dan memulai eksekusi data. Sebagai efek samping, tindakan ini juga menjadikan sheet baru sebagai sheet aktif.

Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data bagi 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',
);

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

Nama	Jenis	Deskripsi
`spec`	`DataSourceSpec`	Spesifikasi 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. Ukuran gambar diambil dari konten blob. Ukuran blob maksimum yang didukung adalah 2 MB.

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

const binaryData = [];  // TODO(developer): Replace with your binary data.
const blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1);

Parameter

Nama	Jenis	Deskripsi
`blobSource`	`BlobSource`	Blob yang berisi konten gambar, jenis MIME, dan (opsional) nama.
`column`	`Integer`	Posisi kolom.
`row`	`Integer`	Posisi 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. Ukuran blob maksimum yang didukung adalah 2 MB.

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

const binaryData = [];  // TODO(developer): Replace with your binary data.
const blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1, 10, 10);

Parameter

Nama	Jenis	Deskripsi
`blobSource`	`BlobSource`	Blob yang berisi konten gambar, jenis MIME, dan (opsional) nama.
`column`	`Integer`	Posisi kolom.
`row`	`Integer`	Posisi baris.
`offsetX`	`Integer`	Offset horizontal dari sudut sel dalam piksel.
`offsetY`	`Integer`	Offset 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.

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

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

Parameter

Nama	Jenis	Deskripsi
`url`	`String`	URL gambar.
`column`	`Integer`	Posisi kolom petak.
`row`	`Integer`	Posisi 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.

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

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

Parameter

Nama	Jenis	Deskripsi
`url`	`String`	URL gambar.
`column`	`Integer`	Posisi kolom.
`row`	`Integer`	Posisi baris.
`offsetX`	`Integer`	Offset horizontal dari sudut sel dalam piksel.
`offsetY`	`Integer`	Offset 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 diberikan.

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

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

Parameter

Nama	Jenis	Deskripsi
`afterPosition`	`Integer`	Baris setelah baris baru harus ditambahkan.

Pulang pergi

Sheet — Lembar, 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 tertentu.

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

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

Parameter

Nama	Jenis	Deskripsi
`beforePosition`	`Integer`	Baris sebelum baris baru harus ditambahkan.

Pulang pergi

Sheet — Lembar, 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.

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

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

Parameter

Nama	Jenis	Deskripsi
`afterPosition`	`Integer`	Baris setelah baris baru harus ditambahkan.
`howMany`	`Integer`	Jumlah baris yang akan disisipkan.

Pulang pergi

Sheet — Lembar, 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 diberikan.

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

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

Parameter

Nama	Jenis	Deskripsi
`beforePosition`	`Integer`	Baris sebelum baris baru harus ditambahkan.
`howMany`	`Integer`	Jumlah baris yang akan disisipkan.

Pulang pergi

Sheet — Lembar, 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 sheet baru ke dalam spreadsheet, menggunakan nama sheet default. Sheet baru akan menjadi sheet aktif.

const 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 yang diberikan. Sheet baru akan menjadi sheet aktif.

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

Parameter

Nama	Jenis	Deskripsi
`sheetIndex`	`Integer`	Indeks sheet yang baru dibuat. Untuk menyisipkan sheet sebagai sheet pertama dalam spreadsheet, 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 argumen lanjutan opsional. Sheet baru akan menjadi sheet aktif.

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

Parameter

Nama	Jenis	Deskripsi
`sheetIndex`	`Integer`	Indeks sheet yang baru dibuat. Untuk menyisipkan sheet sebagai sheet pertama dalam spreadsheet, tetapkan ke 0.
`options`	`Object`	Argumen lanjutan JavaScript opsional.

Parameter lanjutan

Nama	Jenis	Deskripsi
`template`	`Sheet`	Semua data dari objek lembar template disalin ke lembar baru. Template sheet harus berupa salah satu sheet 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 argumen lanjutan opsional. Sheet baru akan menjadi sheet aktif.

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

Parameter

Nama	Jenis	Deskripsi
`options`	`Object`	Argumen lanjutan JavaScript opsional, yang tercantum di bawah.

Parameter lanjutan

Nama	Jenis	Deskripsi
`template`	`Sheet`	Semua data dari objek lembar template disalin ke lembar 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 yang diberikan. Sheet baru akan menjadi sheet aktif.

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

Parameter

Nama	Jenis	Deskripsi
`sheetName`	`String`	Nama 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 sheet baru ke dalam spreadsheet dengan nama tertentu pada indeks tertentu. Sheet baru akan menjadi sheet aktif.

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

Parameter

Nama	Jenis	Deskripsi
`sheetName`	`String`	Nama sheet baru.
`sheetIndex`	`Integer`	Indeks sheet yang baru dibuat. Untuk menyisipkan sheet sebagai sheet pertama dalam spreadsheet, 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 sheet baru ke dalam spreadsheet dengan nama yang diberikan pada indeks yang diberikan dan menggunakan argumen lanjutan opsional. Sheet baru akan menjadi sheet aktif.

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

Parameter

Nama	Jenis	Deskripsi
`sheetName`	`String`	Nama sheet baru.
`sheetIndex`	`Integer`	Indeks sheet yang baru disisipkan. Untuk menyisipkan sheet sebagai sheet pertama dalam spreadsheet, tetapkan ke 0.
`options`	`Object`	Argumen lanjutan JavaScript opsional.

Parameter lanjutan

Nama	Jenis	Deskripsi
`template`	`Sheet`	Semua data dari objek lembar template disalin ke lembar baru. Template sheet harus berupa salah satu sheet 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 yang diberikan dan menggunakan argumen lanjutan opsional. Sheet baru akan menjadi sheet aktif.

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

Parameter

Nama	Jenis	Deskripsi
`sheetName`	`String`	Nama sheet baru.
`options`	`Object`	Argumen lanjutan JavaScript opsional.

Parameter lanjutan

Nama	Jenis	Deskripsi
`template`	`Sheet`	Semua data dari objek lembar template disalin ke lembar baru. Template sheet harus berupa salah satu sheet 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 seluruh sheet dengan spesifikasi sumber data yang diberikan, dan memulai eksekusi data. Sebagai efek samping, membuat sheet baru menjadi sheet aktif.

Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data bagi 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',
);

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

Nama	Jenis	Deskripsi
`spec`	`DataSourceSpec`	Spesifikasi 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 tertentu disembunyikan oleh pengguna.

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

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

Parameter

Nama	Jenis	Deskripsi
`columnPosition`	`Integer`	Posisi kolom yang akan diperiksa.

Pulang pergi

Boolean — true 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 dalam 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

Boolean — true 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 diberikan disembunyikan oleh filter (bukan tampilan filter).

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

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

Parameter

Nama	Jenis	Deskripsi
`rowPosition`	`Integer`	Posisi baris yang akan diperiksa.

Pulang pergi

Boolean — true jika baris disembunyikan, false jika tidak.

Otorisasi

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

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

`isRowHiddenByUser(rowPosition)`

Menampilkan apakah baris tertentu disembunyikan oleh pengguna.

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

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

Parameter

Nama	Jenis	Deskripsi
`rowPosition`	`Integer`	Posisi baris yang akan diperiksa.

Pulang pergi

Boolean — true 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 negatif atau lebih besar dari jumlah sheet.

// 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.
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// Gets the "first" sheet and activates it.
const 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

Nama	Jenis	Deskripsi
`pos`	`Integer`	Posisi indeks 1 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 diberikan ke sheet tersebut. Jika diagram sudah ada di sheetnya sendiri, sheet tersebut akan ditampilkan tanpa membuat sheet baru.

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

Parameter

Nama	Jenis	Deskripsi
`chart`	`EmbeddedChart`	Diagram 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 datanya yang ditautkan, dengan melewati objek sumber data yang tidak valid.

Gunakan metode SpreadsheetApp#enable...Execution() untuk mengaktifkan eksekusi data bagi 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 memblokir pengguna mengakses Spreadsheet jika mereka termasuk dalam kelas pengguna yang memiliki akses umum—misalnya, jika Spreadsheet dibagikan dengan 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 pelihat.

Parameter

Nama	Jenis	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang akan dihapus.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

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

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

Parameter

Nama	Jenis	Deskripsi
`user`	`User`	Representasi pengguna yang akan dihapus.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

Skrip yang 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() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.addMenu('badMenu', [
    {name: 'remove bad menu', functionName: 'removeBadMenu'},
    {name: 'foo', functionName: 'foo'},
  ]);
}
function removeBadMenu() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.removeMenu(
      'badMenu');  // name must match the name used when added the menu
}
function foo() {
  // Do nothing
}

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama 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 dengan nama yang diberikan. Menampilkan pengecualian jika tidak ada rentang dengan nama yang diberikan ditemukan dalam spreadsheet.

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

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama 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 penonton dan pemberi komentar untuk Spreadsheet. Metode ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat atau pemberi komentar. Metode ini juga tidak memblokir pengguna agar tidak mengakses Spreadsheet jika mereka termasuk dalam kelas pengguna yang memiliki akses umum—misalnya, jika Spreadsheet dibagikan dengan 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

Nama	Jenis	Deskripsi
`emailAddress`	`String`	Alamat email pengguna yang akan dihapus.

Pulang pergi

Spreadsheet — Spreadsheet ini untuk dirangkaikan.

Otorisasi

Skrip yang 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 penonton dan pemberi komentar untuk Spreadsheet. Metode ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat. Metode ini juga tidak memblokir pengguna mengakses Spreadsheet jika mereka termasuk dalam kelas pengguna yang memiliki akses umum—misalnya, jika Spreadsheet dibagikan dengan 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

Nama	Jenis	Deskripsi
`user`	`User`	Representasi pengguna yang akan dihapus.

Pulang pergi

Spreadsheet — Spreadsheet ini untuk dirangkaikan.

Otorisasi

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
ss.rename('This is the new name');

Parameter

Nama	Jenis	Deskripsi
`newName`	`String`	Nama 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 aktif saat ini dengan nama baru yang diberikan.

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

Parameter

Nama	Jenis	Deskripsi
`newName`	`String`	Nama baru untuk sheet 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.

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

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

Parameter

Nama	Jenis	Deskripsi
`range`	`Range`	Rentang yang akan 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 di sheet aktif. Rentang terakhir dalam daftar ditetapkan sebagai active range.

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

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

Parameter

Nama	Jenis	Deskripsi
`rangeList`	`RangeList`	Daftar rentang yang akan 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 pilihan aktif untuk sheet ini.

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

const range = sheet.getRange('A1:D4');
sheet.setActiveSelection(range);

Parameter

Nama	Jenis	Deskripsi
`range`	`Range`	Rentang 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, seperti yang ditentukan dalam notasi A1 atau notasi R1C1.

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

sheet.setActiveSelection('A1:D4');

Parameter

Nama	Jenis	Deskripsi
`a1Notation`	`String`	Rentang yang akan ditetapkan sebagai aktif, seperti yang 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 tertentu sebagai sheet aktif dalam spreadsheet. UI Google Spreadsheet menampilkan sheet yang dipilih, kecuali jika sheet tersebut termasuk dalam spreadsheet yang berbeda.

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

Parameter

Nama	Jenis	Deskripsi
`sheet`	`Sheet`	Sheet 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 tertentu sebagai sheet aktif dalam spreadsheet, dengan opsi untuk memulihkan pilihan terbaru dalam sheet tersebut. UI Google Spreadsheet menampilkan sheet yang dipilih kecuali jika sheet tersebut termasuk dalam spreadsheet yang berbeda.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const firstSheet = spreadsheet.getSheets()[0];
const 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
const range = spreadsheet.getActiveSheet().getSelection().getActiveRange();
Logger.log(range.getA1Notation());

Parameter

Nama	Jenis	Deskripsi
`sheet`	`Sheet`	Sheet aktif baru.
`restoreSelection`	`Boolean`	Jika `true`, pilihan terbaru dari sheet aktif baru akan dipilih lagi saat sheet baru menjadi aktif; jika `false`, sheet baru akan menjadi aktif tanpa mengubah pilihan saat ini.

Pulang pergi

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

`setColumnWidth(columnPosition, width)`

Menetapkan lebar kolom tertentu dalam piksel.

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

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

Parameter

Nama	Jenis	Deskripsi
`columnPosition`	`Integer`	Posisi kolom tertentu yang akan ditetapkan.
`width`	`Integer`	Lebar dalam piksel yang akan ditetapkan.

Pulang pergi

Sheet — Lembar, 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, pilihan yang ada akan dihapus dan sel tersebut akan menjadi sel saat ini dan rentang aktif.

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

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

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

Parameter

Nama	Jenis	Deskripsi
`cell`	`Range`	Sel 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 jumlah kolom yang ditentukan. Jika nol, tidak ada kolom yang dibekukan.

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

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

Parameter

Nama	Jenis	Deskripsi
`columns`	`Integer`	Jumlah kolom yang akan dibekukan.

Otorisasi

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

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

`setFrozenRows(rows)`

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

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

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

Parameter

Nama	Jenis	Deskripsi
`rows`	`Integer`	Jumlah 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 perhitungan iteratif. Jika hasil penghitungan berturut-turut berbeda kurang dari nilai ini, penghitungan iteratif akan berhenti. Nilai ini harus non-negatif, dan defaultnya adalah 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

Nama	Jenis	Deskripsi
`minThreshold`	`Number`	Ambang batas konvergensi minimum (harus bukan negatif).

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

Skrip yang 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 dalam spreadsheet ini. Jika jumlah maksimum siklus perhitungan dan nilai minimum konvergensi belum ditetapkan sebelumnya saat perhitungan diaktifkan, nilai defaultnya adalah 50 dan 0,05. Jika salah satunya telah ditetapkan sebelumnya, nilai tersebut akan 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

Nama	Jenis	Deskripsi
`isEnabled`	`Boolean`	`true` jika penghitungan berulang harus diaktifkan; `false` jika tidak.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

Skrip yang 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 penghitungan iteratif. 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

Nama	Jenis	Deskripsi
`maxIterations`	`Integer`	Jumlah maksimum iterasi penghitungan (antara 1 dan 10.000).

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

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

Memberi nama rentang.

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

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama yang akan diberikan ke rentang.
`range`	`Range`	Spesifikasi 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

Nama	Jenis	Deskripsi
`recalculationInterval`	`RecalculationInterval`	Interval penghitungan ulang baru.

Pulang pergi

Spreadsheet — Spreadsheet ini, untuk dirangkaikan.

Otorisasi

Skrip yang 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 dari baris tertentu dalam piksel. Secara default, baris akan diperluas agar sesuai dengan isi sel. Jika Anda ingin memaksa baris ke tinggi yang ditentukan, gunakan Sheet.setRowHeightsForced(startRow, numRows, height).

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

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

Parameter

Nama	Jenis	Deskripsi
`rowPosition`	`Integer`	Posisi baris yang akan diubah.
`height`	`Integer`	Tinggi dalam piksel yang akan ditetapkan.

Pulang pergi

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

Nama	Jenis	Deskripsi
`locale`	`String`	Kode 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.

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

Parameter

Nama	Jenis	Deskripsi
`theme`	`SpreadsheetTheme`	Tema yang akan diterapkan.

Pulang pergi

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

`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

Nama	Jenis	Deskripsi
`timezone`	`String`	Zona waktu, yang ditentukan dalam format "long" (misalnya, "America/New_York", seperti yang tercantum di 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 berada di tengah area tampilan browser pengguna. Eksekusi skrip sisi server tidak ditangguhkan. Untuk berkomunikasi dengan sisi server, komponen antarmuka pengguna harus membuat callback asinkron ke skrip sisi server.

Jika skrip sisi server sebelumnya menampilkan dialog yang belum ditutup, maka 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:

const 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

Nama	Jenis	Deskripsi
`userInterface`	`Object`	`HtmlOutput`.

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 menurut kolom, menaik.

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

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

Parameter

Nama	Jenis	Deskripsi
`columnPosition`	`Integer`	Kolom yang akan diurutkan.

Pulang pergi

Sheet — Lembar, 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 menurut kolom. Menggunakan parameter untuk menentukan urutan menaik atau menurun.

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

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

Parameter

Nama	Jenis	Deskripsi
`columnPosition`	`Integer`	Kolom yang akan diurutkan.
`ascending`	`Boolean`	`true` untuk pengurutan menaik, `false` untuk menurun.

Pulang pergi

Sheet — Lembar, 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 pojok kanan bawah spreadsheet dengan pesan yang diberikan.

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

Parameter

Nama	Jenis	Deskripsi
`msg`	`String`	Pesan 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 pop-up di pojok kanan bawah spreadsheet dengan pesan dan judul yang diberikan.

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

Parameter

Nama	Jenis	Deskripsi
`msg`	`String`	Pesan yang akan ditampilkan di toast.
`title`	`String`	Judul 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 pop-up di pojok kanan bawah spreadsheet dengan judul dan pesan yang diberikan, 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

Nama	Jenis	Deskripsi
`msg`	`String`	Pesan yang akan ditampilkan di toast.
`title`	`String`	Judul opsional toast.
`timeoutSeconds`	`Number`	Waktu tunggu dalam detik; jika `null`, toast akan ditampilkan selama 5 detik secara default; jika negatif, toast akan tetap ditampilkan hingga 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)`

Menampilkan kolom dalam rentang yang ditentukan.

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

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

Parameter

Nama	Jenis	Deskripsi
`column`	`Range`	Rentang yang akan ditampilkan, 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)`

Menampilkan baris dalam rentang yang diberikan.

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

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

Parameter

Nama	Jenis	Deskripsi
`row`	`Range`	Rentang yang akan ditampilkan, 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).

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

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama menu yang akan diupdate.
`subMenus`	`Object[]`	Array peta JavaScript dengan parameter `name` dan `functionName`. Anda dapat menggunakan fungsi dari pustaka 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 hingga semua eksekusi saat ini di spreadsheet selesai, dan akan kehabisan waktu setelah jumlah detik yang diberikan. Menampilkan pengecualian jika eksekusi tidak selesai saat waktu habis, tetapi tidak membatalkan eksekusi data.

Parameter

Nama	Jenis	Deskripsi
`timeoutInSeconds`	`Integer`	Waktu untuk menunggu eksekusi data, dalam detik. Maksimum 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

`getSheetProtection()`

Tidak digunakan lagi. Untuk spreadsheet yang dibuat di Google Spreadsheet versi yang lebih baru, gunakan Sheet.getProtections(type), yang menampilkan class Protection yang lebih canggih. Meskipun metode ini tidak digunakan lagi, metode ini tetap tersedia untuk kompatibilitas dengan versi lama Spreadsheet

Menampilkan instance PageProtection yang menjelaskan izin untuk sheet saat ini.

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

const permissions = sheet.getSheetProtection();

permissions.setProtected(true);
permissions.addUser('user@example.com');

// Logs the users that have access to edit this sheet. Note that this
// is different from access to the entire spreadsheet - getUsers()
// only returns users if permissions.isProtected() is set to true.
const users = permissions.getUsers();
Logger.log(users);

Pulang pergi

PageProtection — Objek yang menjelaskan izin akses 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

`isAnonymousView()`

Tidak digunakan lagi. Mulai Januari 2014, fungsi ini tidak digunakan lagi dan tidak tersedia di Google Spreadsheet versi baru.

Menunjukkan apakah dokumen mengizinkan penayangan anonim. Karena tidak lagi didukung di Google Spreadsheet versi baru, gunakan File.getSharingAccess() dan File.getSharingPermission() sebagai gantinya.

// Determine if the document allows anonymous viewing via the Drive API.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const file = DriveApp.getFileById(ss.getId());
const access = file.getSharingAccess();
const permission = file.getSharingPermission();
const isAnonymousAccess = access === DriveApp.Access.ANYONE ||
    access === DriveApp.Access.ANYONE_WITH_LINK;
const isAnonymousEdit =
    isAnonymousAccess && permission !== DriveApp.Permission.NONE;

Pulang pergi

Boolean — true jika dokumen mengizinkan penayangan anonim, 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

Lihat juga

Layanan Drive

`isAnonymousWrite()`

Tidak digunakan lagi. Mulai Januari 2014, fungsi ini tidak digunakan lagi dan tidak tersedia di Google Spreadsheet versi baru.

Menunjukkan apakah dokumen mengizinkan pengeditan dari pengguna anonim. Karena tidak lagi didukung di versi baru Google Spreadsheet, gunakan File.getSharingAccess() dan File.getSharingPermission() sebagai gantinya.

// Determine if the document allow anonymous edits via the Drive API.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const file = DriveApp.getFileById(ss.getId());
const access = file.getSharingAccess();
const permission = file.getSharingPermission();
const isAnonymousAccess = access === DriveApp.Access.ANYONE ||
    access === DriveApp.Access.ANYONE_WITH_LINK;
const isAnonymousEdit =
    isAnonymousAccess && permission === DriveApp.Permission.EDIT;

Pulang pergi

Boolean — true jika dokumen mengizinkan pengeditan anonim, 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

Lihat juga

Layanan Drive

`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`

Tidak digunakan lagi. Mulai Januari 2014, fungsi ini tidak digunakan lagi dan tidak tersedia di Google Spreadsheet versi baru.

Menetapkan kebijakan dokumen terkait pembacaan dan penulisan anonim. Karena tidak lagi didukung di Google Spreadsheet versi baru, gunakan File.setSharing(accessType, permissionType) sebagai alternatif.

// Set the document's policy on anonymous reading and writing via the Drive API.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const file = DriveApp.getFileById(ss.getId());

// Set anonymous read.
file.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.VIEW);

// Set anonymous write.
file.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

// Disable anonymous access.
file.setSharing(DriveApp.Access.PRIVATE, file.getSharingPermission());

Parameter

Nama	Jenis	Deskripsi
`anonymousReadAllowed`	`Boolean`	`true` untuk mengizinkan pembacaan anonim; `false` jika tidak.
`anonymousWriteAllowed`	`Boolean`	`true` untuk mengizinkan pembacaan anonim; `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

Lihat juga

isAnonymousView()
isAnonymousWrite()
Layanan Drive

`setSheetProtection(permissions)`

Tidak digunakan lagi. Untuk spreadsheet yang dibuat di Google Spreadsheet versi yang lebih baru, gunakan Sheet.protect(), yang menampilkan class Protection yang lebih canggih. Meskipun metode ini tidak digunakan lagi, metode ini tetap tersedia untuk kompatibilitas dengan versi Sheets yang lebih lama

Menetapkan izin untuk sheet saat ini.

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

const permissions = sheet.getSheetProtection();

// This copies the permissions on the first sheet to the second sheet
const sheetToClonePermissionsTo = ss.getSheets()[1];
sheetToClonePermissionsTo.setSheetProtection(permissions);

Parameter

Nama	Jenis	Deskripsi
`permissions`	`PageProtection`	Objek izin akses yang akan ditetapkan di sheet ini.

Otorisasi

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

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

Class Spreadsheet Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Metode

Metode yang tidak digunakan lagi

Dokumentasi mendetail

addDeveloperMetadata(key)

Parameter

Pulang pergi

Otorisasi

addDeveloperMetadata(key, visibility)

Parameter

Pulang pergi

Otorisasi

addDeveloperMetadata(key, value)

Parameter

Pulang pergi

Otorisasi

addDeveloperMetadata(key, value, visibility)

Parameter

Pulang pergi

Otorisasi

addEditor(emailAddress)

Parameter

Pulang pergi

Otorisasi

addEditor(user)

Parameter

Pulang pergi

Otorisasi

addEditors(emailAddresses)

Parameter

Pulang pergi

Otorisasi

addMenu(name, subMenus)

Parameter

Otorisasi

addViewer(emailAddress)

Parameter

Pulang pergi

Otorisasi

addViewer(user)

Parameter

Pulang pergi

Otorisasi

addViewers(emailAddresses)

Parameter

Pulang pergi

Otorisasi

appendRow(rowContents)

Parameter

Pulang pergi

Otorisasi

autoResizeColumn(columnPosition)

Parameter

Pulang pergi

Otorisasi

copy(name)

Parameter

Pulang pergi

Otorisasi

createDeveloperMetadataFinder()

Pulang pergi

createTextFinder(findText)

Parameter

Pulang pergi

deleteActiveSheet()

Pulang pergi

Otorisasi

deleteColumn(columnPosition)

Parameter

Pulang pergi

Otorisasi

deleteColumns(columnPosition, howMany)

Parameter

Otorisasi

deleteRow(rowPosition)

Parameter

Pulang pergi

Otorisasi

deleteRows(rowPosition, howMany)

Parameter

Class Spreadsheet

`addDeveloperMetadata(key)`

`addDeveloperMetadata(key, visibility)`

`addDeveloperMetadata(key, value)`

`addDeveloperMetadata(key, value, visibility)`

`addEditor(emailAddress)`

`addEditor(user)`

`addEditors(emailAddresses)`

`addMenu(name, subMenus)`

`addViewer(emailAddress)`

`addViewer(user)`

`addViewers(emailAddresses)`

`appendRow(rowContents)`

`autoResizeColumn(columnPosition)`

`copy(name)`

`createDeveloperMetadataFinder()`

`createTextFinder(findText)`

`deleteActiveSheet()`

`deleteColumn(columnPosition)`

`deleteColumns(columnPosition, howMany)`

`deleteRow(rowPosition)`

`deleteRows(rowPosition, howMany)`

`deleteSheet(sheet)`

`duplicateActiveSheet()`

`getActiveCell()`

`getActiveRange()`

`getActiveRangeList()`

`getActiveSheet()`

`getAs(contentType)`

`getBandings()`

`getBlob()`

`getColumnWidth(columnPosition)`

`getCurrentCell()`

`getDataRange()`

`getDataSourceFormulas()`

`getDataSourcePivotTables()`

`getDataSourceRefreshSchedules()`

`getDataSourceSheets()`

`getDataSourceTables()`

`getDataSources()`

`getDeveloperMetadata()`

`getEditors()`

`getFormUrl()`

`getFrozenColumns()`

`getFrozenRows()`