Mengakses dan mengubah file Google Spreadsheet. Operasi yang umum dilakukan adalah menambahkan sheet baru dan menambahkan kolaborator.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
addDeveloperMetadata(key) | Spreadsheet | Menambahkan metadata developer dengan kunci yang ditentukan ke spreadsheet level teratas. |
addDeveloperMetadata(key, visibility) | Spreadsheet | Menambahkan metadata developer dengan visibilitas dan kunci 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 yang ditentukan ke daftar editor untuk Spreadsheet . |
addEditor(user) | Spreadsheet | Menambahkan pengguna yang ditentukan 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 audiens untuk Spreadsheet . |
addViewer(user) | Spreadsheet | Menambahkan pengguna tertentu ke daftar audiens untuk Spreadsheet . |
addViewers(emailAddresses) | Spreadsheet | Menambahkan array pengguna tertentu ke daftar audiens untuk Spreadsheet . |
appendRow(rowContents) | Sheet | Menambahkan baris ke bagian bawah region data saat ini di sheet. |
autoResizeColumn(columnPosition) | Sheet | Menetapkan 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 saat ini aktif. |
deleteColumn(columnPosition) | Sheet | Menghapus kolom di posisi kolom yang ditentukan. |
deleteColumns(columnPosition, howMany) | void | Menghapus sejumlah kolom mulai dari posisi kolom tertentu. |
deleteRow(rowPosition) | Sheet | Menghapus baris pada posisi baris tertentu. |
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 yang aktif. |
getActiveCell() | Range | Menampilkan sel aktif dalam sheet ini. |
getActiveRange() | Range | Menampilkan rentang yang dipilih di sheet aktif, atau null jika tidak ada rentang aktif. |
getActiveRangeList() | RangeList | 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 garis miring di spreadsheet ini. |
getBlob() | Blob | Menampilkan data di dalam objek ini sebagai blob. |
getColumnWidth(columnPosition) | Integer | Mendapatkan lebar dalam piksel untuk kolom yang diberikan. |
getCurrentCell() | Range | Menampilkan sel saat ini dalam sheet aktif atau null jika tidak ada sel saat ini. |
getDataRange() | Range | Menampilkan Range yang sesuai dengan dimensi yang menampilkan data. |
getDataSourceFormulas() | DataSourceFormula[] | Mendapatkan semua formula sumber data. |
getDataSourcePivotTables() | DataSourcePivotTable[] | Mendapatkan semua tabel pivot sumber data. |
getDataSourceRefreshSchedules() | DataSourceRefreshSchedule[] | Mendapatkan jadwal pembaruan spreadsheet ini. |
getDataSourceSheets() | DataSourceSheet[] | Menampilkan semua sheet sumber data dalam spreadsheet. |
getDataSourceTables() | DataSourceTable[] | Mendapatkan semua tabel sumber data. |
getDataSources() | DataSource[] | Menampilkan semua sumber data dalam spreadsheet. |
getDeveloperMetadata() | DeveloperMetadata[] | Dapatkan metadata developer yang terkait dengan spreadsheet tingkat atas. |
getEditors() | User[] | Mendapatkan daftar editor untuk Spreadsheet ini. |
getFormUrl() | String | Menampilkan URL untuk formulir yang mengirim respons 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 over-the-grid di sheet. |
getIterativeCalculationConvergenceThreshold() | Number | Menampilkan nilai ambang batas yang digunakan selama penghitungan berulang. |
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 penghitungan berulang. |
getName() | String | Mendapatkan nama dokumen. |
getNamedRanges() | NamedRange[] | Mendapatkan semua rentang bernama di 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 yang telah ditentukan. |
getProtections(type) | Protection[] | Mendapatkan array objek yang mewakili semua rentang atau sheet yang dilindungi di 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 ditemukan rentang dengan nama yang ditentukan. |
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 piksel dalam baris tertentu. |
getSelection() | Selection | Menampilkan Selection saat ini di spreadsheet. |
getSheetByName(name) | Sheet | 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 nilai persegi panjang untuk rentang ini mulai dari koordinat yang diberikan. |
getSheets() | Sheet[] | Mendapatkan semua sheet di spreadsheet ini. |
getSpreadsheetLocale() | String | Mendapatkan lokalitas spreadsheet. |
getSpreadsheetTheme() | SpreadsheetTheme | 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 tertentu. |
getViewers() | User[] | Mendapatkan daftar pelihat dan pengomentar untuk Spreadsheet ini. |
hideColumn(column) | void | Menyembunyikan satu atau beberapa kolom dalam rentang yang ditentukan. |
hideRow(row) | void | Menyembunyikan baris dalam rentang yang diberikan. |
insertColumnAfter(afterPosition) | Sheet | Menyisipkan kolom setelah posisi kolom yang ditentukan. |
insertColumnBefore(beforePosition) | Sheet | Menyisipkan kolom sebelum posisi kolom yang ditentukan. |
insertColumnsAfter(afterPosition, howMany) | Sheet | Menyisipkan sejumlah kolom setelah posisi kolom yang ditentukan. |
insertColumnsBefore(beforePosition, howMany) | Sheet | Menyisipkan sejumlah kolom sebelum posisi kolom yang ditentukan. |
insertDataSourceSheet(spec) | DataSourceSheet | Menyisipkan DataSourceSheet baru di spreadsheet dan memulai eksekusi data. |
insertImage(blobSource, column, row) | OverGridImage | Menyisipkan Spreadsheet sebagai gambar di 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 di baris dan kolom tertentu. |
insertImage(url, column, row, offsetX, offsetY) | OverGridImage | Menyisipkan gambar dalam dokumen di baris dan kolom tertentu, dengan offset piksel. |
insertRowAfter(afterPosition) | Sheet | Menyisipkan baris setelah posisi baris yang ditentukan. |
insertRowBefore(beforePosition) | Sheet | Menyisipkan baris sebelum posisi baris yang ditentukan. |
insertRowsAfter(afterPosition, howMany) | Sheet | Menyisipkan sejumlah baris setelah posisi baris tertentu. |
insertRowsBefore(beforePosition, howMany) | Sheet | Menyisipkan sejumlah baris sebelum posisi baris tertentu. |
insertSheet() | Sheet | Menyisipkan sheet baru ke spreadsheet, menggunakan nama sheet default. |
insertSheet(sheetIndex) | Sheet | Menyisipkan sheet baru ke spreadsheet pada indeks tertentu. |
insertSheet(sheetIndex, options) | Sheet | Menyisipkan sheet baru ke spreadsheet pada indeks tertentu dan menggunakan argumen lanjutan opsional. |
insertSheet(options) | Sheet | Menyisipkan sheet baru ke spreadsheet, menggunakan nama sheet default dan argumen lanjutan opsional. |
insertSheet(sheetName) | Sheet | Menyisipkan sheet baru ke spreadsheet dengan nama yang diberikan. |
insertSheet(sheetName, sheetIndex) | Sheet | Menyisipkan sheet baru ke spreadsheet dengan nama yang diberikan pada indeks tertentu. |
insertSheet(sheetName, sheetIndex, options) | Sheet | Menyisipkan sheet baru ke spreadsheet dengan nama yang diberikan pada indeks tertentu dan menggunakan argumen lanjutan opsional. |
insertSheet(sheetName, options) | Sheet | Menyisipkan sheet baru ke 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 tertentu, dan memulai eksekusi data. |
isColumnHiddenByUser(columnPosition) | Boolean | Menampilkan apakah kolom tertentu disembunyikan oleh pengguna. |
isIterativeCalculationEnabled() | Boolean | Menampilkan apakah penghitungan berulang diaktifkan di spreadsheet ini. |
isRowHiddenByFilter(rowPosition) | Boolean | Menampilkan apakah baris tertentu disembunyikan oleh filter (bukan tampilan filter). |
isRowHiddenByUser(rowPosition) | Boolean | Menampilkan apakah baris tertentu disembunyikan oleh pengguna. |
moveActiveSheet(pos) | void | Memindahkan sheet aktif ke posisi tertentu dalam daftar sheet. |
moveChartToObjectSheet(chart) | Sheet | Membuat sheet SheetType.OBJECT baru dan memindahkan diagram yang disediakan ke dalamnya. |
refreshAllDataSources() | void | Memuat ulang semua sumber data yang didukung dan objek sumber datanya yang tertaut, serta mengabaikan 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 pelihat dan pengomentar untuk Spreadsheet . |
removeViewer(user) | Spreadsheet | Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Spreadsheet . |
rename(newName) | void | Mengganti nama dokumen. |
renameActiveSheet(newName) | void | Mengganti nama sheet yang aktif saat ini menjadi nama baru yang ditentukan. |
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 dalam
sheet aktif. |
setActiveSelection(range) | Range | Menetapkan wilayah pemilihan yang aktif untuk sheet ini. |
setActiveSelection(a1Notation) | Range | Menyetel pemilihan aktif, seperti yang ditentukan dalam notasi A1 atau notasi R1C1. |
setActiveSheet(sheet) | Sheet | Menetapkan sheet yang ditentukan menjadi sheet aktif dalam spreadsheet. |
setActiveSheet(sheet, restoreSelection) | Sheet | Menetapkan sheet yang ditentukan menjadi sheet aktif dalam spreadsheet, dengan opsi untuk memulihkan pilihan terbaru dalam sheet tersebut. |
setColumnWidth(columnPosition, width) | Sheet | Menetapkan lebar kolom yang diberikan dalam piksel. |
setCurrentCell(cell) | Range | Menetapkan sel yang ditentukan sebagai current cell . |
setFrozenColumns(columns) | void | Membekukan jumlah kolom tertentu. |
setFrozenRows(rows) | void | Membekukan jumlah baris yang ditentukan. |
setIterativeCalculationConvergenceThreshold(minThreshold) | Spreadsheet | Menetapkan nilai minimum untuk penghitungan berulang. |
setIterativeCalculationEnabled(isEnabled) | Spreadsheet | Menetapkan apakah penghitungan berulang diaktifkan di spreadsheet ini. |
setMaxIterativeCalculationCycles(maxIterations) | Spreadsheet | Menetapkan jumlah iterasi penghitungan maksimum yang harus dilakukan selama penghitungan berulang. |
setNamedRange(name, range) | void | Memberi nama rentang. |
setRecalculationInterval(recalculationInterval) | Spreadsheet | Menetapkan seberapa sering spreadsheet ini harus dihitung ulang. |
setRowHeight(rowPosition, height) | Sheet | Menetapkan tinggi baris untuk baris yang ditentukan dalam piksel. |
setSpreadsheetLocale(locale) | void | Menetapkan lokal spreadsheet. |
setSpreadsheetTheme(theme) | SpreadsheetTheme | Menetapkan tema di spreadsheet. |
setSpreadsheetTimeZone(timezone) | void | Menetapkan zona waktu untuk spreadsheet. |
show(userInterface) | void | Menampilkan komponen antarmuka pengguna kustom dalam dialog yang berpusat di area pandang browser pengguna. |
sort(columnPosition) | Sheet | Mengurutkan sheet berdasarkan kolom, secara menaik. |
sort(columnPosition, ascending) | Sheet | Mengurutkan sheet berdasarkan 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 judul dan pesan yang diberikan. |
toast(msg, title, timeoutSeconds) | void | Menampilkan jendela pop-up di pojok kanan bawah spreadsheet dengan judul dan pesan tertentu, yang tetap terlihat selama jangka waktu tertentu. |
unhideColumn(column) | void | Memperlihatkan kolom dalam rentang yang diberikan. |
unhideRow(row) | void | Memperlihatkan baris dalam rentang yang diberikan. |
updateMenu(name, subMenus) | void | Memperbarui menu yang ditambahkan oleh addMenu(name, subMenus) . |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | Menunggu sampai semua eksekusi saat ini dalam spreadsheet selesai, dengan waktu habis setelah jumlah detik yang diberikan. |
Dokumentasi mendetail
addDeveloperMetadata(key)
Menambahkan metadata developer dengan kunci yang ditentukan ke spreadsheet level teratas.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
key | String | Kunci untuk metadata developer baru. |
Pulang pergi
Spreadsheet
— Spreadsheet ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Menambahkan metadata developer dengan visibilitas dan kunci yang ditentukan ke spreadsheet.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
key | String | Kunci untuk metadata developer baru. |
visibility | DeveloperMetadataVisibility | Visibilitas metadata developer baru. |
Pulang pergi
Spreadsheet
— Spreadsheet ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Menambahkan metadata developer dengan kunci dan nilai yang ditentukan ke spreadsheet.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
key | String | Kunci untuk metadata developer baru. |
value | String | Nilai untuk metadata developer baru. |
Pulang pergi
Spreadsheet
— Spreadsheet ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Menambahkan metadata developer dengan kunci, nilai, dan visibilitas yang ditentukan ke spreadsheet.
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 perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditor(emailAddress)
Menambahkan pengguna yang ditentukan ke daftar editor untuk Spreadsheet
. Jika pengguna sudah ada dalam daftar pengakses, metode ini akan mempromosikan pengguna keluar dari daftar audiens.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan ditambahkan. |
Pulang pergi
Spreadsheet
— Ini adalah Spreadsheet
, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditor(user)
Menambahkan pengguna yang ditentukan ke daftar editor untuk Spreadsheet
. Jika pengguna sudah ada dalam daftar pengakses, metode ini akan mempromosikan pengguna keluar dari daftar audiens.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan ditambahkan. |
Pulang pergi
Spreadsheet
— Ini adalah Spreadsheet
, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditors(emailAddresses)
Menambahkan array pengguna tertentu ke daftar editor untuk Spreadsheet
. Jika salah satu pengguna sudah ada dalam daftar pengakses, metode ini akan mempromosikan mereka keluar dari daftar pengakses.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddresses | String[] | Array alamat email pengguna yang akan ditambahkan. |
Pulang pergi
Spreadsheet
— Ini adalah Spreadsheet
, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addMenu(name, subMenus)
Membuat menu baru di UI Spreadsheet.
Setiap entri menu menjalankan fungsi yang ditentukan pengguna. Biasanya, Anda 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() { var ss = SpreadsheetApp.getActiveSpreadsheet(); var menuEntries = []; // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is // executed. menuEntries.push({name: "Menu Entry 1", functionName: "function1"}); menuEntries.push(null); // line separator menuEntries.push({name: "Menu Entry 2", functionName: "function2"}); ss.addMenu("addMenuExample", menuEntries); }
Parameter
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 library yang disertakan, seperti
Library.libFunction1 . |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addViewer(emailAddress)
Menambahkan pengguna tertentu ke daftar audiens 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
— Ini adalah Spreadsheet
, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addViewer(user)
Menambahkan pengguna tertentu ke daftar audiens 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
— Ini adalah Spreadsheet
, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addViewers(emailAddresses)
Menambahkan array pengguna tertentu ke daftar audiens untuk Spreadsheet
. Jika ada pengguna yang 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
— Ini adalah Spreadsheet
, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
appendRow(rowContents)
Menambahkan baris ke bagian bawah region data saat ini di sheet.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Appends a new row with 3 columns to the bottom of the current // data region in the sheet containing the values in the array. sheet.appendRow(["a man", "a plan", "panama"]);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
rowContents | Object[] | Array nilai yang akan disisipkan setelah baris terakhir dalam sheet. |
Pulang pergi
Sheet
— Sheet, yang berguna untuk perantaian metode.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnPosition)
Menetapkan lebar kolom yang diberikan agar sesuai dengan kontennya.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...'); // Sets the first column to a width which fits the text sheet.autoResizeColumn(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
columnPosition | Integer | Posisi kolom yang akan diubah ukurannya. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copy(name)
Menyalin spreadsheet dan menampilkan spreadsheet baru.
// This code makes a copy of the current spreadsheet and names it appropriately var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.copy("Copy of " + ss.getName());
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | Nama salinan. |
Pulang pergi
Spreadsheet
— Spreadsheet ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Menampilkan DeveloperMetadataFinder
untuk menemukan metadata developer dalam cakupan
spreadsheet ini. Secara default, ini mempertimbangkan semua metadata yang terkait dengan spreadsheet,
sheet, baris, dan kolom.
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.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Creates a text finder. var textFinder = spreadsheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the spreadsheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
findText | String | Teks yang akan ditelusuri. |
Pulang pergi
TextFinder
— TextFinder
untuk spreadsheet.
deleteActiveSheet()
Menghapus sheet yang saat ini aktif.
// The code below deletes the currently active sheet and stores the new active sheet in a // variable var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();
Pulang pergi
Sheet
— Sheet 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 di posisi kolom yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
columnPosition | Integer | Posisi kolom, mulai dari 1 untuk kolom pertama. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
Menghapus sejumlah kolom mulai dari posisi kolom tertentu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
Parameter
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 tertentu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first row sheet.deleteRow(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
rowPosition | Integer | Posisi baris, mulai dari 1 untuk baris pertama. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
Menghapus sejumlah baris yang dimulai pada posisi baris tertentu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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. var ss = SpreadsheetApp.getActive(); var 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 yang aktif.
// The code below makes a duplicate of the active sheet SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();
Pulang pergi
Sheet
— Sheet baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveCell()
Menampilkan sel aktif dalam sheet ini.
Catatan: Sebaiknya gunakan getCurrentCell()
, yang menampilkan sel yang disorot
saat ini.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var 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 akan menampilkan rentang terakhir yang dipilih.
Istilah "rentang aktif" mengacu pada rentang yang telah dipilih pengguna di sheet aktif, namun dalam fungsi kustom, rentang ini mengacu pada sel yang dihitung ulang secara aktif.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
Pulang pergi
Range
— rentang aktif
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Lihat juga
getActiveRangeList()
Menampilkan daftar rentang aktif di sheet aktif atau null
jika tidak ada rentang
aktif.
Jika ada satu rentang yang dipilih, ini akan berperilaku sebagai panggilan getActiveRange()
.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Pulang pergi
RangeList
— daftar rentang aktif
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Lihat juga
getActiveSheet()
Mendapatkan sheet aktif dalam spreadsheet.
Sheet aktif dalam spreadsheet adalah sheet yang ditampilkan di UI spreadsheet.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
Pulang pergi
Sheet
— Sheet aktif di spreadsheet.
getAs(contentType)
Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. Metode ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, diasumsikan bahwa bagian dari nama file yang mengikuti periode terakhir (jika ada) adalah ekstensi yang sudah ada dan harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".
Untuk melihat kuota harian untuk 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. |
Pulang pergi
Blob
— Data sebagai blob.
getBandings()
Menampilkan semua garis miring di spreadsheet ini.
Pulang pergi
Banding[]
— Tanda hubung di spreadsheet ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBlob()
getColumnWidth(columnPosition)
Mendapatkan lebar dalam piksel untuk kolom yang diberikan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 dalam sheet aktif atau null
jika tidak ada sel saat ini. Sel
saat ini adalah sel yang memiliki fokus di UI Google Spreadsheet, dan ditandai oleh batas
gelap. Tidak pernah ada lebih dari satu sel saat ini. Ketika pengguna memilih satu atau beberapa rentang sel,
salah satu sel dalam pilihan adalah sel saat ini.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
Pulang pergi
Range
— sel saat ini
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRange()
Menampilkan Range
yang sesuai dengan dimensi yang menampilkan data.
Ini secara fungsional setara dengan membuat Rentang yang dibatasi oleh A1 dan (Sheet.getLastColumn(), Sheet.getLastRow()).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This represents ALL the data var range = sheet.getDataRange(); var values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (var i = 0; i < values.length; i++) { var row = ""; for (var j = 0; j < values[i].length; j++) { if (values[i][j]) { row = row + values[i][j]; } row = row + ","; } Logger.log(row); }
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.
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.
Pulang pergi
DataSourcePivotTable[]
— Daftar tabel pivot sumber data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceRefreshSchedules()
Mendapatkan jadwal pembaruan spreadsheet ini.
Pulang pergi
DataSourceRefreshSchedule[]
— Jadwal pembaruan spreadsheet ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceSheets()
Menampilkan semua sheet sumber data dalam spreadsheet.
Pulang pergi
DataSourceSheet[]
— Array dari 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.
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.
Pulang pergi
DataSource[]
— Array dari 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()
Dapatkan metadata developer yang terkait dengan spreadsheet tingkat atas.
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 yang memiliki 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 mengirim respons ke spreadsheet ini, atau null
jika spreadsheet ini tidak memiliki formulir terkait. Jika beberapa formulir mengirim respons ke spreadsheet ini,
URL formulir yang ditampilkan tidak dapat ditentukan. Sebagai alternatif, pengaitan URL formulir per sheet dapat
diambil melalui metode Sheet.getFormUrl()
.
Pulang pergi
String
— URL untuk formulir yang menempatkan responsnya dalam 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
Pulang pergi
Integer
— jumlah kolom beku
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenRows()
Menampilkan jumlah baris yang dibekukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
Pulang pergi
Integer
— jumlah baris beku
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getId()
Mendapatkan ID unik untuk spreadsheet ini. ID spreadsheet dapat diekstrak dari URL-nya. Misalnya, ID spreadsheet di URL https://docs.google.com/spreadsheet/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 unik (atau kunci) untuk spreadsheet.
getImages()
Menampilkan semua gambar over-the-grid di sheet.
Pulang pergi
OverGridImage[]
— Array gambar over-the-grid.
Otorisasi
Skrip yang 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 ambang batas yang digunakan selama penghitungan berulang. Jika hasil kalkulasi berturut-turut lebih kecil daripada nilai ini, penghitungan berulang akan berhenti.
Pulang pergi
Number
— Nilai minimum konvergensi.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
Menampilkan posisi kolom terakhir yang memiliki konten.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Pulang pergi
Integer
— kolom terakhir pada sheet yang berisi konten
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
Menampilkan posisi baris terakhir yang memiliki konten.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
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 penghitungan berulang.
Pulang pergi
Integer
— Jumlah iterasi penghitungan maksimum.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getName()
Mendapatkan nama dokumen.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getName());
Pulang pergi
String
— Nama spreadsheet.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNamedRanges()
Mendapatkan semua rentang bernama di spreadsheet ini.
// The code below logs the name of the first named range. var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); for (var i = 0; i < namedRanges.length; i++) { Logger.log(namedRanges[i].getName()); }
Pulang pergi
NamedRange[]
— Array dari semua rentang bernama dalam spreadsheet.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumSheets()
Menampilkan jumlah sheet dalam spreadsheet ini.
// The code below logs the number of sheets in the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());
Pulang pergi
Integer
— Jumlah sheet dalam spreadsheet.
getOwner()
Menampilkan pemilik dokumen, atau null
untuk dokumen di drive bersama.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var owner = ss.getOwner(); Logger.log(owner.getEmail());
Pulang pergi
User
— Pemilik dokumen, atau null
jika dokumen berada di drive bersama.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPredefinedSpreadsheetThemes()
Menampilkan daftar tema yang telah ditentukan.
// The code below returns the list of predefined themes. var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet() .getPredefinedSpreadsheetThemes();
Pulang pergi
SpreadsheetTheme[]
— Daftar tema yang telah 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
getProtections(type)
Mendapatkan array objek yang mewakili semua rentang atau sheet yang dilindungi di spreadsheet.
// Remove all range protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove all sheet protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
type | ProtectionType | Jenis area yang dilindungi, baik SpreadsheetApp.ProtectionType.RANGE atau
SpreadsheetApp.ProtectionType.SHEET . |
Pulang pergi
Protection[]
— Array objek yang mewakili semua rentang atau sheet yang dilindungi di spreadsheet.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(a1Notation)
Menampilkan rentang seperti yang ditentukan dalam notasi A1 atau notasi R1C1.
// Get a range A1:D4 on sheet titled "Invoices" var ss = SpreadsheetApp.getActiveSpreadsheet(); var range = ss.getRange("Invoices!A1:D4"); // Get cell A1 on the first sheet var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1");
Parameter
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 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
getRangeByName(name)
Menampilkan rentang bernama, atau null
jika tidak ditemukan rentang dengan nama yang ditentukan. 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. var 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. var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var 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 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
getRecalculationInterval()
Menampilkan interval penghitungan untuk spreadsheet ini.
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 piksel dalam baris tertentu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 di spreadsheet.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Pulang pergi
Selection
— pilihan saat ini
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetByName(name)
Menampilkan sheet dengan nama yang diberikan.
Jika beberapa sheet memiliki nama yang sama, yang 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" var 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
— Sheet dengan nama yang diberikan.
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 waktu pembuatan sheet yang tidak bergantung pada posisi sheet. Hal ini
berguna bersama dengan metode seperti Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
yang menggunakan parameter gridId
, bukan instance Sheet
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Pulang pergi
Integer
— ID untuk sheet yang unik untuk spreadsheet
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetName()
Menampilkan nama sheet.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Pulang pergi
String
— nama sheet
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(startRow, startColumn, numRows, numColumns)
Menampilkan petak nilai persegi panjang untuk rentang ini mulai dari koordinat yang diberikan. Nilai -1 yang diberikan sebagai posisi baris atau kolom sama dengan mendapatkan baris atau kolom terakhir yang memiliki data di sheet.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
startRow | Integer | Posisi baris awal. |
startColumn | Integer | Posisi kolom awal. |
numRows | Integer | Jumlah baris untuk menampilkan nilai. |
numColumns | Integer | Jumlah kolom yang nilainya akan ditampilkan. |
Pulang pergi
Object[][]
— array nilai dua dimensi
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheets()
Mendapatkan semua sheet di spreadsheet ini.
// The code below logs the name of the second sheet var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets(); if (sheets.length > 1) { Logger.log(sheets[1].getName()); }
Pulang pergi
Sheet[]
— Array dari semua sheet di spreadsheet.
getSpreadsheetLocale()
Mendapatkan lokalitas spreadsheet.
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. var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();
Pulang pergi
SpreadsheetTheme
— Tema yang diterapkan saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSpreadsheetTimeZone()
Mendapatkan zona waktu untuk spreadsheet.
Pulang pergi
String
— Zona waktu, ditentukan dalam format "panjang" (misalnya, "America/New_York", seperti yang tercantum
oleh Joda.org).
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getUrl()
Menampilkan URL untuk spreadsheet tertentu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getUrl());
Pulang pergi
String
— URL untuk spreadsheet tertentu.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getViewers()
Mendapatkan daftar pelihat dan pengomentar untuk Spreadsheet
ini.
Pulang pergi
User[]
— Array pengguna dengan izin lihat atau komentar.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
Menyembunyikan satu atau beberapa kolom dalam rentang yang ditentukan.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange("A1"); sheet.hideColumn(range); // This hides the first 3 columns let range = sheet.getRange("A:C"); sheet.hideColumn(range);
Parameter
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This hides the first row var range = sheet.getRange("A1"); sheet.hideRow(range);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
row | Range | Rentang baris untuk disembunyikan. |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnAfter(afterPosition)
Menyisipkan kolom setelah posisi kolom yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
afterPosition | Integer | Kolom yang akan digunakan untuk menambahkan kolom baru. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
Menyisipkan kolom sebelum posisi kolom yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
beforePosition | Integer | Kolom yang akan menambahkan kolom baru. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsAfter(afterPosition, howMany)
Menyisipkan sejumlah kolom setelah posisi kolom yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the second column position sheet.insertColumnsAfter(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
afterPosition | Integer | Kolom yang akan digunakan untuk menambahkan kolom baru. |
howMany | Integer | Jumlah kolom yang akan disisipkan. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsBefore(beforePosition, howMany)
Menyisipkan sejumlah kolom sebelum posisi kolom yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
beforePosition | Integer | Kolom yang akan menambahkan kolom baru. |
howMany | Integer | Jumlah kolom yang akan disisipkan. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertDataSourceSheet(spec)
Menyisipkan DataSourceSheet
baru di spreadsheet dan memulai eksekusi data. Sebagai
efek samping, hal ini juga akan 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.
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 di dokumen pada baris dan kolom tertentu. Ukuran gambar
diambil dari konten blob. Ukuran blob maksimum yang didukung adalah 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
blobSource | BlobSource | Blob yang berisi konten gambar, jenis MIME, dan nama (opsional). |
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
blobSource | BlobSource | Blob yang berisi konten gambar, jenis MIME, dan nama (opsional). |
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 di baris dan kolom tertentu.
URL yang diberikan harus dapat diakses secara publik.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
Parameter
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 di baris dan kolom tertentu, dengan offset piksel.
URL yang diberikan harus dapat diakses secara publik.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
url | String | URL untuk 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 ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
afterPosition | Integer | Baris yang berisi baris baru harus ditambahkan. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowBefore(beforePosition)
Menyisipkan baris sebelum posisi baris yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
beforePosition | Integer | Baris yang harus ditambahkan baris baru. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsAfter(afterPosition, howMany)
Menyisipkan sejumlah baris setelah posisi baris tertentu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
afterPosition | Integer | Baris yang berisi baris baru harus ditambahkan. |
howMany | Integer | Jumlah baris yang akan disisipkan. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsBefore(beforePosition, howMany)
Menyisipkan sejumlah baris sebelum posisi baris tertentu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
beforePosition | Integer | Baris yang harus ditambahkan baris baru. |
howMany | Integer | Jumlah baris yang akan disisipkan. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet()
Menyisipkan sheet baru ke spreadsheet, menggunakan nama sheet default. Sheet baru ini akan menjadi sheet aktif.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet();
Pulang pergi
Sheet
— Sheet baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetIndex)
Menyisipkan sheet baru ke spreadsheet pada indeks tertentu. Sheet baru akan menjadi sheet aktif.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
sheetIndex | Integer | Indeks sheet yang baru dibuat. Untuk menyisipkan sheet sebagai sheet pertama di 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 spreadsheet pada indeks tertentu dan menggunakan argumen lanjutan opsional. Sheet baru akan menjadi sheet aktif.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 di spreadsheet, tetapkan ke 0. |
options | Object | Argumen lanjutan JavaScript opsional. |
Parameter lanjutan
Nama | Jenis | Deskripsi |
---|---|---|
template | Sheet | Semua data dari objek sheet template disalin ke sheet baru. Template sheet harus berupa salah satu sheet dari objek Spreadsheet. |
Pulang pergi
Sheet
— Sheet baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(options)
Menyisipkan sheet baru ke spreadsheet, menggunakan nama sheet default dan argumen lanjutan opsional. Sheet baru akan menjadi sheet aktif.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 sheet template disalin ke sheet baru. Template sheet harus berupa salah satu sheet dari objek Spreadsheet ini. |
Pulang pergi
Sheet
— Sheet baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName)
Menyisipkan sheet baru ke spreadsheet dengan nama yang diberikan. Sheet baru akan menjadi sheet aktif.
var 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 spreadsheet dengan nama yang diberikan pada indeks tertentu. Sheet baru menjadi sheet aktif.
var 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 di 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 spreadsheet dengan nama yang diberikan pada indeks tertentu dan menggunakan argumen lanjutan opsional. Sheet baru akan menjadi sheet aktif.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', 1, {template: templateSheet});
Parameter
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 sheet template disalin ke sheet baru. Template sheet harus berupa salah satu sheet dari objek Spreadsheet. |
Pulang pergi
Sheet
— Sheet baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName, options)
Menyisipkan sheet baru ke spreadsheet dengan nama yang diberikan dan menggunakan argumen lanjutan opsional. Sheet baru akan menjadi sheet aktif.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', {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 sheet template disalin ke sheet baru. Template sheet harus berupa salah satu sheet dari objek Spreadsheet. |
Pulang pergi
Sheet
— Sheet baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheetWithDataSourceTable(spec)
Menyisipkan sheet baru dalam spreadsheet, membuat DataSourceTable
yang mencakup
seluruh sheet dengan spesifikasi sumber data tertentu, 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.
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 di spreadsheet ini.
Pulang pergi
Boolean
— true
jika penghitungan berulang diaktifkan, jika tidak false
.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByFilter(rowPosition)
Menampilkan apakah baris tertentu disembunyikan oleh filter (bukan tampilan filter).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
Parameter
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 tertentu 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. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Gets the "first" sheet and activates it. var sheet = spreadsheet.getSheetByName("first").activate(); // Logs 'Current index of sheet: 1' console.log("Current index of sheet: %s", sheet.getIndex()); spreadsheet.moveActiveSheet(2); // Logs 'New index of sheet: 2' console.log("New index of sheet: %s", sheet.getIndex());
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
pos | Integer | Posisi 1 indeks untuk memindahkan sheet aktif ke dalam daftar sheet. |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveChartToObjectSheet(chart)
Membuat sheet SheetType.OBJECT
baru dan memindahkan diagram yang disediakan ke dalamnya. Jika diagram
sudah ada di sheetnya sendiri, sheet tersebut akan ditampilkan tanpa membuat sheet baru.
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.newChart().setPosition(1, 1, 0, 0).build(); sheet.insertChart(chart); var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);
Parameter
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 tertaut, serta mengabaikan objek sumber data yang tidak valid.
Gunakan metode SpreadsheetApp#enable...Execution()
untuk mengaktifkan eksekusi data bagi
jenis sumber data 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
removeEditor(emailAddress)
Menghapus pengguna tertentu dari daftar editor untuk Spreadsheet
. Metode ini tidak
memblokir pengguna untuk mengakses Spreadsheet
jika mereka berasal dari class pengguna yang memiliki
akses umum—misalnya, jika Spreadsheet
dibagikan ke seluruh domain
pengguna, atau jika Spreadsheet
berada di drive bersama yang dapat diakses pengguna.
Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar pengakses.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan dihapus. |
Pulang pergi
Spreadsheet
— Ini adalah Spreadsheet
, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeEditor(user)
Menghapus pengguna tertentu dari daftar editor untuk Spreadsheet
. Metode ini tidak
memblokir pengguna untuk mengakses Spreadsheet
jika mereka berasal dari class pengguna yang memiliki
akses umum—misalnya, jika Spreadsheet
dibagikan ke seluruh domain
pengguna, atau jika Spreadsheet
berada di drive bersama yang dapat diakses pengguna.
Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar pengakses.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan dihapus. |
Pulang pergi
Spreadsheet
— Ini adalah Spreadsheet
, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeMenu(name)
Menghapus menu yang ditambahkan oleh addMenu(name, subMenus)
. Argumen name
harus memiliki nilai yang sama dengan panggilan ke addMenu(name, subMenus)
.
// The onOpen function is executed automatically every time a Spreadsheet is loaded function onOpen() { var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"}, {name: "foo", functionName: "foo"}]); } function removeBadMenu() { var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.removeMenu("badMenu"); // name must match the name used when added the menu } function foo(){ // Do nothing }
Parameter
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. Melempar pengecualian jika tidak ada rentang dengan nama yang ditentukan dalam spreadsheet.
// The code below creates a new named range "foo", and then remove it. var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.setNamedRange("foo", ss.getActiveRange()); ss.removeNamedRange("foo");
Parameter
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 pelihat dan pengomentar untuk Spreadsheet
. Metode ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat atau pengomentar. Metode ini juga
tidak memblokir pengguna untuk mengakses Spreadsheet
jika mereka berasal dari class pengguna yang
memiliki akses umum—misalnya, jika Spreadsheet
dibagikan ke seluruh
domain pengguna, atau jika Spreadsheet
berada di drive bersama yang dapat diakses pengguna.
Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar editor.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan dihapus. |
Pulang pergi
Spreadsheet
— Ini adalah Spreadsheet
untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeViewer(user)
Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Spreadsheet
. Metode ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat. Metode ini juga tidak memblokir
pengguna untuk mengakses Spreadsheet
jika mereka berasal dari class pengguna yang memiliki akses
umum—misalnya, jika Spreadsheet
dibagikan kepada 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
— Ini adalah Spreadsheet
untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
rename(newName)
Mengganti nama dokumen.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.rename("This is the new name");
Parameter
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 yang aktif saat ini menjadi nama baru yang ditentukan.
// 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
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var range = sheet.getRange('A1:D4'); sheet.setActiveRange(range); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D4 var activeRange = selection.getActiveRange();
Parameter
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
dalam
sheet aktif. Rentang terakhir dalam daftar ditetapkan sebagai active range
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); sheet.setActiveRangeList(rangeList); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
rangeList | RangeList | Daftar rentang yang dapat dipilih. |
Pulang pergi
RangeList
— daftar rentang yang baru dipilih
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(range)
Menetapkan wilayah pemilihan yang aktif untuk sheet ini.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var 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)
Menyetel pemilihan aktif, seperti yang ditentukan dalam notasi A1 atau notasi R1C1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.setActiveSelection("A1:D4");
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
a1Notation | String | Rentang yang 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 yang ditentukan menjadi sheet aktif dalam spreadsheet. UI Google Spreadsheet akan menampilkan sheet yang dipilih kecuali sheet tersebut milik spreadsheet yang berbeda.
// The code below makes the first sheet active in the active spreadsheet. var 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 yang ditentukan menjadi sheet aktif dalam spreadsheet, dengan opsi untuk memulihkan pilihan terbaru dalam sheet tersebut. UI Google Spreadsheet akan menampilkan sheet yang dipilih, kecuali sheet tersebut termasuk dalam spreadsheet yang berbeda.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var firstSheet = spreadsheet.getSheets()[0]; var secondSheet = spreadsheet.getSheets()[1]; // Set the first sheet as the active sheet and select the range D4:F4. spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate(); // Switch to the second sheet to do some work. spreadsheet.setActiveSheet(secondSheet); // Switch back to first sheet, and restore its selection. spreadsheet.setActiveSheet(firstSheet, true); // The selection of first sheet is restored, and it logs D4:F4 var range = spreadsheet.getActiveSheet().getSelection().getActiveRange(); Logger.log(range.getA1Notation());
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
sheet | Sheet | Sheet aktif yang baru. |
restoreSelection | Boolean | Tf true , pilihan sheet baru yang aktif
akan dipilih lagi saat sheet baru menjadi aktif; jika false , sheet baru
akan 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 yang diberikan dalam piksel.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first column to a width of 200 pixels sheet.setColumnWidth(1, 200);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
columnPosition | Integer | Posisi kolom yang ditentukan untuk ditetapkan. |
width | Integer | Lebar dalam piksel untuk menyetelnya. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setCurrentCell(cell)
Menetapkan sel yang ditentukan sebagai current cell
.
Jika sel yang ditentukan ada dalam rentang yang sudah dipilih, rentang tersebut akan menjadi rentang aktif dengan sel sebagai sel saat ini.
Jika sel yang ditentukan tidak ada dalam rentang yang dipilih, pilihan apa pun yang ada akan dihapus dan sel akan menjadi sel saat ini dan rentang aktif.
Catatan: Range
yang ditentukan harus terdiri dari satu sel, jika tidak, pengecualian akan
ditampilkan.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
cell | Range | Sel yang akan ditetapkan sebagai sel saat ini. |
Pulang pergi
Range
— sel 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 tertentu. Jika nol, tidak ada kolom yang dibekukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 penghitungan berulang. Jika hasil kalkulasi berturut-turut lebih kecil daripada nilai ini, penghitungan berulang akan berhenti. Nilai ini tidak boleh negatif, dan default-nya adalah 0.05.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
minThreshold | Number | Nilai minimum konvergensi minimum (harus tidak negatif). |
Pulang pergi
Spreadsheet
— Spreadsheet ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setIterativeCalculationEnabled(isEnabled)
Menetapkan apakah penghitungan berulang diaktifkan di spreadsheet ini. Jika jumlah maksimum siklus penghitungan dan nilai minimum konvergensi belum ditetapkan saat penghitungan diaktifkan, nilai default masing-masing adalah 50 dan 0,05. Jika salah satunya telah ditetapkan sebelumnya, nilai tersebut akan mempertahankan nilai sebelumnya.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
isEnabled | Boolean | true jika penghitungan berulang harus diaktifkan; jika tidak, false akan diaktifkan. |
Pulang pergi
Spreadsheet
— Spreadsheet ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setMaxIterativeCalculationCycles(maxIterations)
Menetapkan jumlah iterasi penghitungan maksimum yang harus dilakukan selama penghitungan berulang. Nilai ini harus antara 1 dan 10.000 (inklusif), dan default-nya adalah 50.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
maxIterations | Integer | Jumlah maksimum iterasi penghitungan (antara 1 hingga 10.000). |
Pulang pergi
Spreadsheet
— Spreadsheet ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNamedRange(name, range)
Memberi nama rentang.
// The code below creates a new named range "TaxRates" in the active spreadsheet var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.setNamedRange("TaxRates", SpreadsheetApp.getActiveRange());
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | Nama yang akan diberikan 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 dihitung ulang.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
recalculationInterval | RecalculationInterval | Interval penghitungan ulang baru. |
Pulang pergi
Spreadsheet
— Spreadsheet ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeight(rowPosition, height)
Menetapkan tinggi baris untuk baris yang ditentukan dalam piksel. Secara default, baris disesuaikan agar cocok dengan konten sel. Jika
Anda ingin memaksa baris ke tinggi yang ditentukan, gunakan Sheet.setRowHeightsForced(startRow, numRows, height)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first row to a height of 200 pixels sheet.setRowHeight(1, 200);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
rowPosition | Integer | Posisi baris yang akan diubah. |
height | Integer | Tinggi dalam piksel yang akan ditetapkan. |
Pulang pergi
Sheet
— Sheet, yang 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 lokal spreadsheet.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
locale | String | Kode lokal 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 di spreadsheet.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // The code below sets the second predefined theme as the current theme of the spreadsheet. var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes(); spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
theme | SpreadsheetTheme | Tema yang akan diterapkan. |
Pulang pergi
SpreadsheetTheme
— Tema baru saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setSpreadsheetTimeZone(timezone)
Menetapkan zona waktu untuk spreadsheet.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
timezone | String | Zona waktu, yang ditentukan dalam format "panjang" (misalnya, "America/New_York", seperti yang tercantum oleh Joda.org). |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
show(userInterface)
Menampilkan komponen antarmuka pengguna kustom dalam dialog yang berpusat di area pandang 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, dialog yang ada akan diganti dengan antarmuka pengguna dialog yang baru diminta.
Cuplikan kode berikut menampilkan aplikasi HtmlService
sederhana dalam dialog dengan
judul, tinggi, dan lebar yang ditentukan:
var htmlApp = HtmlService .createHtmlOutput('<p>A change of speed, a change of style...</p>') .setTitle('My HtmlService Application') .setWidth(250) .setHeight(300); SpreadsheetApp.getActiveSpreadsheet().show(htmlApp); // The script resumes execution immediately after showing the dialog.
Parameter
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 berdasarkan kolom, secara menaik.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, ascending sheet.sort(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
columnPosition | Integer | Kolom yang akan diurutkan. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition, ascending)
Mengurutkan sheet berdasarkan kolom. Dibutuhkan parameter untuk menentukan menaik atau menurun.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
columnPosition | Integer | Kolom yang akan diurutkan. |
ascending | Boolean | true untuk urutan menaik, false untuk urutan menurun. |
Pulang pergi
Sheet
— sheet, berguna untuk metode perantaian
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 judul dan pesan 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 tertentu, 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 ditetapkan secara default ke 5 detik;
jika negatif, toast akan tetap sampai ditutup. |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideColumn(column)
Memperlihatkan kolom dalam rentang yang diberikan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideColumn(range);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
column | Range | Rentang yang akan diperlihatkan, jika disembunyikan. |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideRow(row)
Memperlihatkan baris dalam rentang yang diberikan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first row if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideRow(range);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
row | Range | Rentang yang akan diperlihatkan, jika disembunyikan. |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateMenu(name, subMenus)
Memperbarui menu yang ditambahkan oleh addMenu(name, subMenus)
. Berfungsi persis seperti addMenu(name, subMenus)
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var menuEntries = []; menuEntries.push({name: "Lone Menu Entry", functionName: "function1"}); ss.updateMenu("addMenuExample", menuEntries);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | Nama menu yang akan diperbarui. |
subMenus | Object[] | Array peta JavaScript dengan parameter name dan functionName
. Anda dapat menggunakan fungsi dari library yang disertakan, seperti
Library.libFunction1 . |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForAllDataExecutionsCompletion(timeoutInSeconds)
Menunggu sampai semua eksekusi saat ini dalam spreadsheet selesai, dengan waktu habis 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 menunggu eksekusi data, dalam detik. Durasi maksimumnya adalah 300 detik. |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets