Mengakses dan mengubah file Google Spreadsheet. Operasi yang umum adalah menambahkan {i>sheet<i} baru dan menambahkan para 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 kunci dan visibilitas yang ditentukan ke spreadsheet. |
addDeveloperMetadata(key, value) | Spreadsheet | Menambahkan metadata developer dengan kunci dan nilai yang ditentukan ke spreadsheet. |
addDeveloperMetadata(key, value, visibility) | Spreadsheet | Menambahkan metadata developer dengan kunci, nilai, dan visibilitas yang ditentukan ke spreadsheet. |
addEditor(emailAddress) | Spreadsheet | Menambahkan pengguna tertentu ke daftar editor untuk Spreadsheet . |
addEditor(user) | Spreadsheet | Menambahkan pengguna tertentu ke daftar editor untuk Spreadsheet . |
addEditors(emailAddresses) | Spreadsheet | Menambahkan array pengguna yang diberikan ke daftar editor untuk Spreadsheet . |
addMenu(name, subMenus) | void | Membuat menu baru di UI Spreadsheet. |
addViewer(emailAddress) | Spreadsheet | Menambahkan pengguna tertentu ke daftar pelihat untuk Spreadsheet . |
addViewer(user) | Spreadsheet | Menambahkan pengguna tertentu ke daftar pelihat untuk Spreadsheet . |
addViewers(emailAddresses) | Spreadsheet | Menambahkan array pengguna yang diberikan ke daftar pelihat 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 pas dengan kontennya. |
copy(name) | Spreadsheet | Menyalin {i>spreadsheet<i} dan menampilkan yang baru. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Menampilkan DeveloperMetadataFinder untuk menemukan metadata developer dalam cakupan
{i>spreadsheet <i}ini. |
createTextFinder(findText) | TextFinder | Membuat pencari teks untuk {i>spreadsheet<i}, yang dapat digunakan untuk menemukan dan mengganti teks di dalam di {i>spreadsheet<i}. |
deleteActiveSheet() | Sheet | Menghapus sheet yang sedang aktif. |
deleteColumn(columnPosition) | Sheet | Menghapus kolom pada posisi kolom yang ditentukan. |
deleteColumns(columnPosition, howMany) | void | Menghapus sejumlah kolom yang dimulai dari posisi kolom yang ditentukan. |
deleteRow(rowPosition) | Sheet | Menghapus baris pada posisi baris tertentu. |
deleteRows(rowPosition, howMany) | void | Menghapus sejumlah baris yang dimulai dari posisi baris yang ditentukan. |
deleteSheet(sheet) | void | Menghapus sheet yang ditentukan. |
duplicateActiveSheet() | Sheet | Menduplikasi sheet aktif dan menjadikannya sheet aktif. |
getActiveCell() | Range | Menampilkan sel aktif dalam sheet ini. |
getActiveRange() | Range | Menampilkan rentang yang dipilih dalam sheet aktif, atau null jika tidak ada rentang yang aktif. |
getActiveRangeList() | RangeList | Menampilkan daftar rentang aktif dalam sheet aktif atau null jika tidak ada yang aktif
rentang. |
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 berwarna di spreadsheet ini. |
getBlob() | Blob | Menampilkan data di dalam objek ini sebagai blob. |
getColumnWidth(columnPosition) | Integer | Mendapatkan lebar dalam piksel dari kolom yang ditentukan. |
getCurrentCell() | Range | Menampilkan sel saat ini dalam sheet yang aktif, atau null jika tidak ada sel saat ini. |
getDataRange() | Range | Menampilkan Range yang sesuai dengan dimensi tempat data tersedia. |
getDataSourceFormulas() | DataSourceFormula[] | Mendapatkan semua formula sumber data. |
getDataSourcePivotTables() | DataSourcePivotTable[] | Mendapatkan semua tabel pivot sumber data. |
getDataSourceRefreshSchedules() | DataSourceRefreshSchedule[] | Mendapatkan jadwal pembaruan spreadsheet ini. |
getDataSourceSheets() | DataSourceSheet[] | Menampilkan semua sheet sumber data dalam spreadsheet. |
getDataSourceTables() | DataSourceTable[] | Mendapatkan semua tabel sumber data. |
getDataSources() | DataSource[] | Menampilkan semua sumber data di spreadsheet. |
getDeveloperMetadata() | DeveloperMetadata[] | Mendapatkan metadata developer yang terkait dengan spreadsheet tingkat atas. |
getEditors() | User[] | Mendapatkan daftar editor untuk Spreadsheet ini. |
getFormUrl() | String | Menampilkan URL untuk formulir yang mengirimkan responsnya ke spreadsheet ini, atau null jika
spreadsheet ini tidak memiliki formulir terkait. |
getFrozenColumns() | Integer | Menampilkan jumlah kolom yang dibekukan. |
getFrozenRows() | Integer | Menampilkan jumlah baris yang dibekukan. |
getId() | String | Mendapatkan ID unik untuk spreadsheet ini. |
getImages() | OverGridImage[] | Menampilkan semua gambar di atas petak pada sheet. |
getIterativeCalculationConvergenceThreshold() | Number | Menampilkan nilai minimum 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 iterasi maksimum yang akan digunakan selama penghitungan berulang. |
getName() | String | Mendapatkan nama dokumen. |
getNamedRanges() | NamedRange[] | Mendapatkan semua rentang bernama dalam spreadsheet ini. |
getNumSheets() | Integer | Menampilkan jumlah sheet dalam spreadsheet ini. |
getOwner() | User | Menampilkan pemilik dokumen, atau null untuk dokumen di drive bersama. |
getPredefinedSpreadsheetThemes() | SpreadsheetTheme[] | Menampilkan daftar tema yang telah ditentukan sebelumnya. |
getProtections(type) | Protection[] | Mendapatkan array objek yang mewakili semua rentang atau sheet dilindungi dalam spreadsheet. |
getRange(a1Notation) | Range | Menampilkan rentang sebagaimana ditentukan dalam notasi A1 atau notasi R1C1. |
getRangeByName(name) | Range | Menampilkan rentang bernama, atau null jika tidak ditemukan rentang dengan nama yang diberikan. |
getRangeList(a1Notations) | RangeList | Menampilkan koleksi RangeList yang mewakili rentang dalam sheet yang sama yang ditentukan
dengan daftar notasi A1 atau notasi R1C1 yang tidak kosong. |
getRecalculationInterval() | RecalculationInterval | Menampilkan interval kalkulasi untuk spreadsheet ini. |
getRowHeight(rowPosition) | Integer | Mendapatkan tinggi dalam piksel dari baris yang ditentukan. |
getSelection() | Selection | Menampilkan Selection saat ini dalam 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, yang dimulai dari koordinat yang diberikan. |
getSheets() | Sheet[] | Mengambil semua sheet dalam 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 yang ditentukan. |
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 ditentukan. |
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 tertentu 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 dalam dokumen pada baris dan kolom tertentu. |
insertImage(blobSource, column, row, offsetX, offsetY) | OverGridImage | Menyisipkan Spreadsheet sebagai gambar dalam dokumen pada baris dan kolom tertentu, dengan
offset piksel. |
insertImage(url, column, row) | OverGridImage | Menyisipkan gambar dalam dokumen pada baris dan kolom tertentu. |
insertImage(url, column, row, offsetX, offsetY) | OverGridImage | Menyisipkan gambar dalam dokumen pada baris dan kolom tertentu, dengan offset piksel. |
insertRowAfter(afterPosition) | Sheet | Menyisipkan baris setelah posisi baris yang ditentukan. |
insertRowBefore(beforePosition) | Sheet | Menyisipkan baris sebelum posisi baris yang ditentukan. |
insertRowsAfter(afterPosition, howMany) | Sheet | Menyisipkan sejumlah baris setelah posisi baris yang ditentukan. |
insertRowsBefore(beforePosition, howMany) | Sheet | Menyisipkan sejumlah baris sebelum posisi baris yang ditentukan. |
insertSheet() | Sheet | Menyisipkan lembar baru ke dalam {i>spreadsheet<i}, menggunakan nama {i>sheet<i} default. |
insertSheet(sheetIndex) | Sheet | Menyisipkan sheet baru ke dalam spreadsheet pada indeks tertentu. |
insertSheet(sheetIndex, options) | Sheet | Menyisipkan sheet baru ke dalam spreadsheet pada indeks yang diberikan dan menggunakan opsi lanjutan argumen. |
insertSheet(options) | Sheet | Menyisipkan sheet baru ke dalam spreadsheet, menggunakan nama sheet default dan opsi lanjutan argumen. |
insertSheet(sheetName) | Sheet | Menyisipkan sheet baru ke dalam spreadsheet dengan nama tertentu. |
insertSheet(sheetName, sheetIndex) | Sheet | Menyisipkan lembar baru ke dalam {i>spreadsheet<i} dengan nama yang diberikan pada indeks yang diberikan. |
insertSheet(sheetName, sheetIndex, options) | Sheet | Menyisipkan lembar baru ke dalam {i>spreadsheet<i} dengan nama yang diberikan pada indeks yang diberikan dan menggunakan argumen lanjutan opsional. |
insertSheet(sheetName, options) | Sheet | Menyisipkan sheet baru ke dalam spreadsheet dengan nama tertentu dan menggunakan opsi lanjutan argumen. |
insertSheetWithDataSourceTable(spec) | Sheet | Menyisipkan sheet baru dalam spreadsheet, membuat DataSourceTable yang mencakup
keseluruhan {i>sheet<i} dengan spesifikasi sumber data yang diberikan, dan memulai eksekusi data. |
isColumnHiddenByUser(columnPosition) | Boolean | Menampilkan apakah kolom yang ditentukan disembunyikan oleh pengguna. |
isIterativeCalculationEnabled() | Boolean | Menampilkan apakah penghitungan berulang diaktifkan di spreadsheet ini. |
isRowHiddenByFilter(rowPosition) | Boolean | Menampilkan apakah baris yang ditentukan disembunyikan oleh filter (bukan tampilan filter). |
isRowHiddenByUser(rowPosition) | Boolean | Menampilkan apakah baris yang ditentukan disembunyikan oleh pengguna. |
moveActiveSheet(pos) | void | Memindahkan sheet aktif ke posisi yang ditentukan dalam daftar sheet. |
moveChartToObjectSheet(chart) | Sheet | Membuat sheet SheetType.OBJECT baru dan memindahkan diagram yang disediakan ke sheet tersebut. |
refreshAllDataSources() | void | Memuat ulang semua sumber data yang didukung dan objek sumber data tertaut, serta melewati nilai yang tidak valid objek sumber data. |
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 yang diberi nama. |
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 diberikan. |
resetSpreadsheetTheme() | SpreadsheetTheme | Menghapus tema yang diterapkan dan menetapkan tema default pada spreadsheet. |
setActiveRange(range) | Range | Menetapkan rentang yang ditentukan sebagai active range di sheet aktif, dengan
sel kiri atas dalam rentang sebagai current cell . |
setActiveRangeList(rangeList) | RangeList | Menetapkan daftar rentang yang ditentukan sebagai active ranges dalam
{i>active sheet<i}. |
setActiveSelection(range) | Range | Menetapkan wilayah pemilihan aktif untuk sheet ini. |
setActiveSelection(a1Notation) | Range | Menetapkan pilihan aktif, sebagaimana ditentukan dalam notasi A1 atau notasi R1C1. |
setActiveSheet(sheet) | Sheet | Menetapkan sheet yang diberikan menjadi sheet aktif dalam spreadsheet. |
setActiveSheet(sheet, restoreSelection) | Sheet | Menetapkan sheet yang diberikan menjadi sheet aktif dalam spreadsheet, dengan opsi untuk memulihkan pilihan terbaru dalam {i>sheet<i} tersebut. |
setColumnWidth(columnPosition, width) | Sheet | Menetapkan lebar kolom yang ditentukan dalam piksel. |
setCurrentCell(cell) | Range | Menetapkan sel yang ditentukan sebagai current cell . |
setFrozenColumns(columns) | void | Membekukan sejumlah kolom yang ditentukan. |
setFrozenRows(rows) | void | Membekukan sejumlah 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 maksimum iterasi penghitungan yang harus dilakukan selama iterasi kalkulasi. |
setNamedRange(name, range) | void | Mencantumkan nama rentang. |
setRecalculationInterval(recalculationInterval) | Spreadsheet | Menetapkan seberapa sering spreadsheet ini harus menghitung ulang. |
setRowHeight(rowPosition, height) | Sheet | Menetapkan tinggi baris untuk baris yang ditentukan dalam piksel. |
setSpreadsheetLocale(locale) | void | Menetapkan lokalitas spreadsheet. |
setSpreadsheetTheme(theme) | SpreadsheetTheme | Menetapkan tema pada spreadsheet. |
setSpreadsheetTimeZone(timezone) | void | Menetapkan zona waktu untuk spreadsheet. |
show(userInterface) | void | Menampilkan komponen antarmuka pengguna kustom dalam dialog yang berpusat di browser browser area pandang. |
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 sudut kanan bawah spreadsheet dengan pesan yang diberikan. |
toast(msg, title) | void | Menampilkan jendela {i>pop-up<i} di sudut kanan bawah {i>spreadsheet<i} dengan pesan yang diberikan dan title. |
toast(msg, title, timeoutSeconds) | void | Menampilkan jendela {i>pop-up<i} di sudut kanan bawah {i>spreadsheet<i} dengan judul yang diberikan dan pesan, yang tetap terlihat selama jangka waktu tertentu. |
unhideColumn(column) | void | Memperlihatkan kolom dalam rentang yang ditentukan. |
unhideRow(row) | void | Memperlihatkan baris dalam rentang yang ditentukan. |
updateMenu(name, subMenus) | void | Memperbarui menu yang ditambahkan oleh addMenu(name, subMenus) . |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | Menunggu sampai semua eksekusi saat ini dalam spreadsheet selesai, waktu habis setelah jumlah detik yang disediakan. |
Dokumentasi mendetail
addDeveloperMetadata(key)
Menambahkan metadata developer dengan kunci yang ditentukan ke spreadsheet level teratas.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME' in the developer metadata for the spreadsheet. ss.addDeveloperMetadata('NAME') // Gets the first developer metadata object and logs its key. const developerMetaData = ss.getDeveloperMetadata()[0] console.log(developerMetaData.getKey())
Parameter
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 kunci dan visibilitas yang ditentukan ke spreadsheet.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME' in the developer metadata for the spreadsheet and sets the visibility // to the developer project that created the metadata. ss.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the first developer metadata object and logs its key and visibility setting. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(`Key: ${developerMetaData.getKey()}, . Visibility: ${developerMetaData.getVisibility()}`);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
key | String | Kunci untuk metadata developer baru. |
visibility | DeveloperMetadataVisibility | Visibilitas metadata developer baru. |
Pulang pergi
Spreadsheet
— Spreadsheet ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Menambahkan metadata developer dengan kunci dan nilai yang ditentukan ke spreadsheet.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME' and sets the value to 'GOOGLE' in the developer metadata for the // spreadsheet. ss.addDeveloperMetadata('NAME', 'GOOGLE'); // Gets the first developer metadata object and logs its key and value. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}`);
Parameter
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.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility // to any developer project with document access. ss.addDeveloperMetadata('NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the first developer metadata object and logs its key, value, and visibility setting. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}, Visibility: ${developerMetaData.getVisibility()}`);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
key | String | Kunci untuk metadata developer baru. |
value | String | Nilai untuk metadata developer baru. |
visibility | DeveloperMetadataVisibility | Visibilitas metadata developer baru. |
Pulang pergi
Spreadsheet
— Spreadsheet ini, untuk perantaian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditor(emailAddress)
Menambahkan pengguna tertentu ke daftar editor untuk Spreadsheet
. Jika pengguna sudah
pada daftar penonton, metode ini mempromosikan pengguna tersebut dari daftar penonton.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan ditambahkan. |
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(user)
Menambahkan pengguna tertentu ke daftar editor untuk Spreadsheet
. Jika pengguna sudah
pada daftar penonton, metode ini mempromosikan pengguna tersebut dari daftar penonton.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan ditambahkan. |
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
addEditors(emailAddresses)
Menambahkan array pengguna yang diberikan ke daftar editor untuk Spreadsheet
. Jika salah satu
pengguna sudah ada di daftar, metode ini mempromosikan mereka dari daftar
penonton.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddresses | String[] | Array alamat email pengguna yang akan ditambahkan. |
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
addMenu(name, subMenus)
Membuat menu baru di UI Spreadsheet.
Setiap entri menu menjalankan fungsi yang ditentukan pengguna. Biasanya, Anda perlu memanggilnya dari fungsi onOpen()
sehingga menu akan otomatis dibuat saat spreadsheet dimuat.
// The onOpen function is executed automatically every time a Spreadsheet is loaded function onOpen() { var ss = SpreadsheetApp.getActiveSpreadsheet(); var menuEntries = []; // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is // executed. menuEntries.push({name: "Menu Entry 1", functionName: "function1"}); menuEntries.push(null); // line separator menuEntries.push({name: "Menu Entry 2", functionName: "function2"}); ss.addMenu("addMenuExample", menuEntries); }
Parameter
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 pelihat untuk Spreadsheet
. Jika pengguna sudah
pada daftar editor, metode ini tidak berpengaruh.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan ditambahkan. |
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
addViewer(user)
Menambahkan pengguna tertentu ke daftar pelihat untuk Spreadsheet
. Jika pengguna sudah
pada daftar editor, metode ini tidak berpengaruh.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan ditambahkan. |
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
addViewers(emailAddresses)
Menambahkan array pengguna yang diberikan ke daftar pelihat untuk Spreadsheet
. Jika salah satu
pengguna sudah ada di daftar editor, metode ini tidak berpengaruh bagi mereka.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddresses | String[] | Array alamat email pengguna yang akan ditambahkan. |
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
appendRow(rowContents)
Menambahkan baris ke bagian bawah region data saat ini di sheet. Jika isi sel dimulai
dengan =
, hal tersebut akan ditafsirkan sebagai formula.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Appends a new row with 3 columns to the bottom of the current // data region in the sheet containing the values in the array. sheet.appendRow(["a man", "a plan", "panama"]);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
rowContents | Object[] | Array nilai yang akan disisipkan setelah baris terakhir dalam sheet. |
Pulang pergi
Sheet
— Sheet ini, berguna untuk perantaian metode.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnPosition)
Menetapkan lebar kolom yang diberikan agar pas dengan kontennya.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...'); // Sets the first column to a width which fits the text sheet.autoResizeColumn(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
columnPosition | Integer | Posisi kolom yang akan diubah ukurannya. |
Pulang pergi
Sheet
— sheet, berguna untuk perantaian metode
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copy(name)
Menyalin {i>spreadsheet<i} dan menampilkan yang baru.
// This code makes a copy of the current spreadsheet and names it appropriately var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.copy("Copy of " + ss.getName());
Parameter
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
{i>spreadsheet <i}ini. Secara {i>default<i} mempertimbangkan semua {i>metadata<i} yang terkait dengan {i>spreadsheet<i},
{i>sheet<i}, baris, dan kolom.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds developer metadata to the spreadsheet. ss.addDeveloperMetadata('NAME', 'CHARLIE'); ss.addDeveloperMetadata('COMPANY', 'EXAMPLE ORGANIZATION'); ss.addDeveloperMetadata('TECHNOLOGY', 'JAVASCRIPT'); // Creates a developer metadata finder. const developerMetadataFinder = ss.createDeveloperMetadataFinder(); // Finds the developer metadata objects with 'COMPANY' as the key. const googleMetadataFromSpreadsheet = developerMetadataFinder.withKey('COMPANY').find(); // Gets the first result of developer metadata that has the key 'COMPANY' and logs its value. console.log(googleMetadataFromSpreadsheet[0].getValue());
Pulang pergi
DeveloperMetadataFinder
— Pencari metadata developer untuk menelusuri metadata dalam cakupan spreadsheet ini.
createTextFinder(findText)
Membuat pencari teks untuk {i>spreadsheet<i}, yang dapat digunakan untuk menemukan dan mengganti teks di dalam di {i>spreadsheet<i}. Penelusuran dimulai dari sheet pertama {i>spreadsheet<i}.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Creates a text finder. var textFinder = spreadsheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the spreadsheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
findText | String | Teks yang akan ditelusuri. |
Pulang pergi
TextFinder
— TextFinder
untuk spreadsheet.
deleteActiveSheet()
Menghapus sheet yang sedang aktif.
// The code below deletes the currently active sheet and stores the new active sheet in a // variable var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();
Pulang pergi
Sheet
— Sheet baru yang aktif.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumn(columnPosition)
Menghapus kolom pada posisi kolom yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
columnPosition | Integer | Posisi kolom, mulai dari 1 untuk kolom pertama. |
Pulang pergi
Sheet
— sheet, berguna untuk perantaian metode
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
Menghapus sejumlah kolom yang dimulai dari posisi kolom yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
Parameter
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 perantaian metode
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
Menghapus sejumlah baris yang dimulai dari posisi baris yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
Parameter
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 aktif.
// The code below makes a duplicate of the active sheet SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();
Pulang pergi
Sheet
— Sheet baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveCell()
Menampilkan sel aktif dalam sheet ini.
Catatan: Sebaiknya gunakan getCurrentCell()
yang menampilkan
sel yang disorot.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
Pulang pergi
Range
— sel yang aktif saat ini
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveRange()
Menampilkan rentang yang dipilih dalam sheet aktif, atau null
jika tidak ada rentang yang aktif. Jika
beberapa rentang dipilih, metode ini hanya menampilkan rentang terakhir yang dipilih.
Istilah "rentang aktif" mengacu pada rentang yang telah dipilih pengguna di {i>sheet aktif<i}, tetapi dalam fungsi khusus, hal ini mengacu pada sel yang secara aktif dihitung ulang.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
Pulang pergi
Range
— rentang aktif
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Lihat juga
getActiveRangeList()
Menampilkan daftar rentang aktif dalam sheet aktif atau null
jika tidak ada yang aktif
rentang.
Jika ada satu rentang yang dipilih, rentang ini akan berperilaku sebagai panggilan getActiveRange()
.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Pulang pergi
RangeList
— daftar rentang aktif
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Lihat juga
getActiveSheet()
Mendapatkan sheet aktif dalam spreadsheet.
Lembar aktif dalam {i>spreadsheet<i} adalah lembar kerja yang sedang ditampilkan di {i>spreadsheet<i} UI.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
Pulang pergi
Sheet
— Sheet aktif di spreadsheet.
getAs(contentType)
Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. Ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, mengasumsikan bahwa bagian dari nama {i>file<i} yang mengikuti titik terakhir (jika ada) adalah bagian yang harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".
Untuk melihat kuota harian untuk konversi, lihat Kuota untuk Google Layanan. Domain Google Workspace yang baru dibuat mungkin tunduk kepada aturan yang lebih ketat kuota tambahan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
contentType | String | Jenis MIME yang menjadi tujuan konversi. Untuk sebagian besar blob, 'application/pdf' adalah
satu-satunya opsi yang valid. Untuk gambar dalam format BMP, GIF, JPEG, atau PNG, dari 'image/bmp' , 'image/gif' , 'image/jpeg' , atau 'image/png' juga
valid. Untuk dokumen Google Dokumen, 'text/markdown' juga valid. |
Pulang pergi
Blob
— Data sebagai blob.
getBandings()
Menampilkan semua garis berwarna di spreadsheet ini.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets an array of the bandings in the spreadsheet. const bandings = ss.getBandings(); // Logs the range of the first banding in the spreadsheet to the console. console.log(bandings[0].getRange().getA1Notation());
Pulang pergi
Banding[]
— Kartu garis di spreadsheet ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBlob()
getColumnWidth(columnPosition)
Mendapatkan lebar dalam piksel dari kolom yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
Parameter
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 yang aktif, atau null
jika tidak ada sel saat ini. Tujuan
sel saat ini adalah sel yang memiliki fokus di UI Google Sheets, dan ditandai dengan warna gelap
{i>border<i}. Tidak pernah ada lebih dari satu sel saat ini. Saat pengguna memilih
satu atau lebih rentang sel,
salah satu sel yang Anda pilih adalah sel yang sedang dipilih.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
Pulang pergi
Range
— sel saat ini
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRange()
Menampilkan Range
yang sesuai dengan dimensi tempat data tersedia.
Secara fungsional, ini sama seperti membuat Rentang yang dibatasi oleh A1 dan (Sheet.getLastColumn(), Sheet.getLastRow()).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This represents ALL the data var range = sheet.getDataRange(); var values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (var i = 0; i < values.length; i++) { var row = ""; for (var j = 0; j < values[i].length; j++) { if (values[i][j]) { row = row + values[i][j]; } row = row + ","; } Logger.log(row); }
Pulang pergi
Range
— rentang yang terdiri dari semua data dalam spreadsheet
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Mendapatkan semua formula sumber data.
// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets // file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source formulas on Sheet1. // To get an array of data source formulas for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceFormulas = sheet.getDataSourceFormulas(); // Logs the first data source formula in the array. console.log(dataSourceFormulas[0].getFormula());
Pulang pergi
DataSourceFormula[]
— Daftar formula sumber data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
Mendapatkan semua tabel pivot sumber data.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source pivot tables on Sheet1. // To get an array of data source pivot tables for the entire // spreadsheet, replace 'sheet' with 'ss'. const dataSourcePivotTables = sheet.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
Pulang pergi
DataSourcePivotTable[]
— Daftar tabel pivot sumber data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceRefreshSchedules()
Mendapatkan jadwal pembaruan spreadsheet ini.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Activates BigQuery operations for the connected spreadsheet. SpreadsheetApp.enableBigQueryExecution(); // Gets the frequency type of the first referesh schedule in the array. const frequencyType = ss.getDataSourceRefreshSchedules()[0] .getFrequency() .getFrequencyType() .toString(); // Logs the frequency type to the console. console.log(frequencyType);
Pulang pergi
DataSourceRefreshSchedule[]
— Jadwal pembaruan spreadsheet ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceSheets()
Menampilkan semua sheet sumber data dalam spreadsheet.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the first data source sheet in the spreadsheet. const dataSource = ss.getDataSourceSheets()[0]; // Gets the name of the data source sheet. console.log(dataSource.asSheet().getName());
Pulang pergi
DataSourceSheet[]
— Array semua sheet sumber data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
Mendapatkan semua tabel sumber data.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of data source tables on Sheet1. // To get an array of data source tables for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceTables = sheet.getDataSourceTables(); // Logs the last completed data execution time on the first data source table. console.log(dataSourceTables[0].getStatus().getLastExecutionTime());
Pulang pergi
DataSourceTable[]
— Daftar tabel sumber data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSources()
Menampilkan semua sumber data di spreadsheet.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the data sources on the spreadsheet. const dataSources = ss.getDataSources(); // Logs the name of the first column on the first data source. console.log(dataSources[0].getColumns()[0].getName());
Pulang pergi
DataSource[]
— Array semua sumber data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Mendapatkan metadata developer yang terkait dengan spreadsheet tingkat atas.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds 'Google' as a key to the spreadsheet metadata. ss.addDeveloperMetadata('Google'); // Gets the spreadsheet's metadata. const ssMetadata = ss.getDeveloperMetadata(); // Gets the first set of the spreadsheet's metadata and logs the key to the console. console.log(ssMetadata[0].getKey());
Pulang pergi
DeveloperMetadata[]
— Metadata developer yang terkait dengan rentang ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getEditors()
Mendapatkan daftar editor untuk Spreadsheet
ini.
Pulang pergi
User[]
— Array pengguna dengan izin edit.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormUrl()
Menampilkan URL untuk formulir yang mengirimkan responsnya ke spreadsheet ini, atau null
jika
spreadsheet ini tidak memiliki formulir terkait. Jika beberapa formulir mengirimkan respons ke spreadsheet ini,
URL formulir yang ditampilkan tidak tentu. Sebagai alternatif, pengaitan URL per sheet dapat
diambil melalui metode Sheet.getFormUrl()
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the form URL from the spreadsheet. const formUrl = ss.getFormUrl(); // Logs the form URL to the console. console.log(formUrl);
Pulang pergi
String
— URL untuk formulir yang menempatkan responsnya di spreadsheet ini, atau null
jika
{i>spreadsheet<i} ini tidak memiliki
formulir terkait.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenColumns()
Menampilkan jumlah kolom yang dibekukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
Pulang pergi
Integer
— jumlah kolom yang dibekukan
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenRows()
Menampilkan jumlah baris yang dibekukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
Pulang pergi
Integer
— jumlah baris yang dibekukan
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getId()
Mendapatkan ID unik untuk spreadsheet ini. ID spreadsheet dapat diekstrak dari URL-nya. Misalnya, ID spreadsheet di URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 adalah "abc1234567".
// The code below logs the ID for the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());
Pulang pergi
String
— ID (atau kunci) unik untuk spreadsheet.
getImages()
Menampilkan semua gambar di atas petak pada sheet.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the over-the-grid images from Sheet1. // To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead. const images = sheet.getImages(); // For each image, logs the anchor cell in A1 notation. for (const image of images) { console.log(image.getAnchorCell().getA1Notation()); }
Pulang pergi
OverGridImage[]
— Array gambar di atas petak.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIterativeCalculationConvergenceThreshold()
Menampilkan nilai minimum yang digunakan selama penghitungan berulang. Ketika hasil berturut-turut berbeda kurang dari nilai ini, penghitungan berulang akan berhenti.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the iterative calculation convergence threshold for the spreadsheet. ss.setIterativeCalculationConvergenceThreshold(2); // Logs the threshold to the console. console.log(ss.getIterativeCalculationConvergenceThreshold());
Pulang pergi
Number
— Nilai minimum konvergensi.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
Menampilkan posisi kolom terakhir yang memiliki konten.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Pulang pergi
Integer
— kolom terakhir sheet yang berisi konten
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
Menampilkan posisi baris terakhir yang memiliki konten.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Pulang pergi
Integer
— baris terakhir sheet yang berisi konten
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxIterativeCalculationCycles()
Menampilkan jumlah iterasi maksimum yang akan digunakan selama penghitungan berulang.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the max iterative calculation cycles for the spreadsheet. ss.setMaxIterativeCalculationCycles(10); // Logs the max iterative calculation cycles to the console. console.log(ss.getMaxIterativeCalculationCycles());
Pulang pergi
Integer
— Jumlah maksimum iterasi penghitungan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getName()
Mendapatkan nama dokumen.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getName());
Pulang pergi
String
— Nama spreadsheet.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNamedRanges()
Mendapatkan semua rentang bernama dalam spreadsheet ini.
// The code below logs the name of the first named range. var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); for (var i = 0; i < namedRanges.length; i++) { Logger.log(namedRanges[i].getName()); }
Pulang pergi
NamedRange[]
— Array semua rentang bernama dalam spreadsheet.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumSheets()
Menampilkan jumlah sheet dalam spreadsheet ini.
// The code below logs the number of sheets in the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());
Pulang pergi
Integer
— Jumlah sheet dalam spreadsheet.
getOwner()
Menampilkan pemilik dokumen, atau null
untuk dokumen di drive bersama.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var owner = ss.getOwner(); Logger.log(owner.getEmail());
Pulang pergi
User
— Pemilik dokumen, atau null
jika dokumen berada di drive bersama.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPredefinedSpreadsheetThemes()
Menampilkan daftar tema yang telah ditentukan sebelumnya.
// The code below returns the list of predefined themes. var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet() .getPredefinedSpreadsheetThemes();
Pulang pergi
SpreadsheetTheme[]
— Daftar tema yang telah ditetapkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getProtections(type)
Mendapatkan array objek yang mewakili semua rentang atau sheet dilindungi dalam spreadsheet.
// Remove all range protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove all sheet protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
type | ProtectionType | Jenis kawasan lindung, SpreadsheetApp.ProtectionType.RANGE atau
SpreadsheetApp.ProtectionType.SHEET . |
Pulang pergi
Protection[]
— Array objek yang mewakili semua rentang atau sheet dilindungi dalam spreadsheet.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(a1Notation)
Menampilkan rentang sebagaimana ditentukan dalam notasi A1 atau notasi R1C1.
// Get a range A1:D4 on sheet titled "Invoices" var ss = SpreadsheetApp.getActiveSpreadsheet(); var range = ss.getRange("Invoices!A1:D4"); // Get cell A1 on the first sheet var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1");
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
a1Notation | String | Rentang yang akan dikembalikan, sebagaimana ditentukan dalam notasi A1 atau notasi R1C1. |
Pulang pergi
Range
— rentang di lokasi yang ditentukan
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRangeByName(name)
Menampilkan rentang bernama, atau null
jika tidak ditemukan rentang dengan nama yang diberikan. Jika lebih dari satu
{i>sheet<i} {i>spreadsheet<i} menggunakan nama rentang yang sama, tentukan nama {i>sheet<i} tanpa tambahan
tanda kutip — misalnya, getRangeByName('TaxRates')
atau getRangeByName('Sheet Name!TaxRates')
, tetapi bukan getRangeByName('"Sheet
Name"!TaxRates')
.
// Log the number of columns for the range named 'TaxRates' in the active spreadsheet. var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates'); if (range != null) { Logger.log(range.getNumColumns()); }
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | Nama rentang yang akan didapatkan. |
Pulang pergi
Range
— Rentang sel dengan nama tertentu.
getRangeList(a1Notations)
Menampilkan koleksi RangeList
yang mewakili rentang dalam sheet yang sama yang ditentukan
dengan daftar notasi A1 atau notasi R1C1 yang tidak kosong.
// Get a list of ranges A1:D4, F1:H4. var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
a1Notations | String[] | Daftar rentang yang akan ditampilkan, sebagaimana ditentukan dalam notasi A1 atau notasi R1C1. |
Pulang pergi
RangeList
— daftar rentang di lokasi yang ditentukan
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRecalculationInterval()
Menampilkan interval kalkulasi untuk spreadsheet ini.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Logs the calculation interval for the spreadsheet to the console. console.log(ss.getRecalculationInterval().toString());
Pulang pergi
RecalculationInterval
— Interval penghitungan untuk spreadsheet ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowHeight(rowPosition)
Mendapatkan tinggi dalam piksel dari baris yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
rowPosition | Integer | Posisi baris yang akan diperiksa. |
Pulang pergi
Integer
— tinggi baris dalam piksel
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
Menampilkan Selection
saat ini dalam spreadsheet.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Pulang pergi
Selection
— pilihan saat ini
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetByName(name)
Menampilkan sheet dengan nama yang diberikan.
Jika beberapa sheet memiliki nama yang sama, sheet yang paling kiri akan ditampilkan. Menampilkan null
jika
tidak ada {i>sheet<i} dengan nama yang diberikan.
// The code below logs the index of a sheet named "Expenses" var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses"); if (sheet != null) { Logger.log(sheet.getIndex()); }
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | Nama sheet yang akan didapatkan. |
Pulang pergi
Sheet
— Sheet dengan nama tertentu.
getSheetId()
Menampilkan ID sheet yang diwakili oleh objek ini.
ID ini adalah ID unik untuk {i>spreadsheet<i}. ID ini bersifat monoton
meningkatkan integer yang ditetapkan pada waktu pembuatan sheet yang tidak bergantung pada posisi sheet. Ini
berguna bersama dengan metode seperti Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
yang menggunakan parameter gridId
, bukan instance Sheet
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Pulang pergi
Integer
— ID untuk sheet yang unik untuk spreadsheet
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetName()
Menampilkan nama sheet.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Pulang pergi
String
— nama sheet
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(startRow, startColumn, numRows, numColumns)
Menampilkan petak nilai persegi panjang untuk rentang ini, yang dimulai dari koordinat yang diberikan. J-1 nilai yang diberikan sebagai posisi baris atau kolom sama dengan mendapatkan baris atau kolom terakhir yang memiliki data dalam {i>sheet<i}.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
startRow | Integer | Posisi baris awal. |
startColumn | Integer | Posisi kolom awal. |
numRows | Integer | Jumlah baris yang nilainya akan ditampilkan. |
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()
Mengambil semua sheet dalam spreadsheet ini.
// The code below logs the name of the second sheet var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets(); if (sheets.length > 1) { Logger.log(sheets[1].getName()); }
Pulang pergi
Sheet[]
— Array dari semua sheet dalam spreadsheet.
getSpreadsheetLocale()
Mendapatkan lokalitas spreadsheet.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the spreadsheet locale. const ssLocale = ss.getSpreadsheetLocale(); // Logs the locale to the console. console.log(ssLocale);
Pulang pergi
String
— Lokal spreadsheet.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSpreadsheetTheme()
Menampilkan tema spreadsheet saat ini, atau null
jika tidak ada tema yang diterapkan.
// The code below returns the current theme of the spreadsheet. var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();
Pulang pergi
SpreadsheetTheme
— Tema yang diterapkan saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSpreadsheetTimeZone()
Mendapatkan zona waktu untuk spreadsheet.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the time zone of the spreadsheet. ss.setSpreadsheetTimeZone('America/New_York'); // Gets the time zone of the spreadsheet. const ssTimeZone = ss.getSpreadsheetTimeZone(); // Logs the time zone to the console. console.log(ssTimeZone);
Pulang pergi
String
— Zona waktu, ditentukan dalam "panjang" (misalnya, "America/New_York", seperti yang tercantum
oleh Joda.org).
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getUrl()
Menampilkan URL untuk spreadsheet yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getUrl());
Pulang pergi
String
— URL untuk spreadsheet tertentu.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getViewers()
Mendapatkan daftar pelihat dan pengomentar untuk Spreadsheet
ini.
Pulang pergi
User[]
— Array pengguna dengan izin lihat atau komentar.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
Menyembunyikan satu atau beberapa kolom dalam rentang yang ditentukan.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange("A1"); sheet.hideColumn(range); // This hides the first 3 columns let range = sheet.getRange("A:C"); sheet.hideColumn(range);
Parameter
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 ditentukan.
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 yang akan disembunyikan. |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnAfter(afterPosition)
Menyisipkan kolom setelah posisi kolom yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
afterPosition | Integer | Kolom yang akan ditambahi kolom baru. |
Pulang pergi
Sheet
— sheet, berguna untuk perantaian metode
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
Menyisipkan kolom sebelum posisi kolom yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
beforePosition | Integer | Kolom yang akan ditambahi kolom baru. |
Pulang pergi
Sheet
— sheet, berguna untuk perantaian metode
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsAfter(afterPosition, howMany)
Menyisipkan sejumlah kolom tertentu setelah posisi kolom yang ditentukan.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Inserts two columns after the first column on the first sheet of the spreadsheet. sheet.insertColumnsAfter(1,2);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
afterPosition | Integer | Kolom yang akan ditambahi kolom baru. |
howMany | Integer | Jumlah kolom yang akan disisipkan. |
Pulang pergi
Sheet
— sheet, berguna untuk perantaian metode
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsBefore(beforePosition, howMany)
Menyisipkan sejumlah kolom sebelum posisi kolom yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
beforePosition | Integer | Kolom yang akan ditambahi kolom baru. |
howMany | Integer | Jumlah kolom yang akan disisipkan. |
Pulang pergi
Sheet
— sheet, berguna untuk perantaian metode
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertDataSourceSheet(spec)
Menyisipkan DataSourceSheet
baru di spreadsheet dan memulai eksekusi data. Sebagai seorang
efek samping, hal ini juga membuat {i>sheet<i} baru menjadi {i>active sheet<i}.
Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Menggunakan metode SpreadsheetApp#enable...Execution()
untuk mengaktifkan eksekusi data bagi sumber data tertentu
.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Builds a data source specification. // TODO (developer): Update the project ID to your own Google Cloud project ID. const dataSourceSpec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('project-id-1') .setTableProjectId('bigquery-public-data') .setDatasetId('ncaa_basketball') .setTableId('mbb_historical_teams_games') .build(); // Adds the data source and its data to the spreadsheet. ss.insertDataSourceSheet(dataSourceSpec);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
spec | DataSourceSpec | Spesifikasi sumber data yang akan disisipkan. |
Pulang pergi
DataSourceSheet
— Sheet sumber data baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row)
Menyisipkan Spreadsheet
sebagai gambar dalam dokumen pada baris dan kolom tertentu. Gambar
akan diambil dari konten blob. Ukuran blob maksimum yang didukung adalah 2 MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
blobSource | BlobSource | Blob yang berisi konten gambar, jenis MIME, dan nama (secara 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. Jumlah blob maksimum yang didukung
berukuran 2MB.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
blobSource | BlobSource | Blob yang berisi konten gambar, jenis MIME, dan nama (secara 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 pada baris dan kolom tertentu.
URL yang diberikan harus dapat diakses secara publik.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
url | String | URL gambar. |
column | Integer | Posisi kolom petak. |
row | Integer | Posisi baris petak. |
Pulang pergi
OverGridImage
— Gambar yang disisipkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row, offsetX, offsetY)
Menyisipkan gambar dalam dokumen pada baris dan kolom tertentu, dengan offset piksel.
URL yang diberikan harus dapat diakses secara publik.
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 akan ditambahi baris baru. |
Pulang pergi
Sheet
— sheet, berguna untuk perantaian metode
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowBefore(beforePosition)
Menyisipkan baris sebelum posisi baris yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
beforePosition | Integer | Baris sebelum baris baru harus ditambahkan. |
Pulang pergi
Sheet
— sheet, berguna untuk perantaian metode
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsAfter(afterPosition, howMany)
Menyisipkan sejumlah baris setelah posisi baris yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
afterPosition | Integer | Baris yang akan ditambahi baris baru. |
howMany | Integer | Jumlah baris yang akan disisipkan. |
Pulang pergi
Sheet
— sheet, berguna untuk perantaian metode
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsBefore(beforePosition, howMany)
Menyisipkan sejumlah baris sebelum posisi baris yang ditentukan.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
beforePosition | Integer | Baris sebelum baris baru harus ditambahkan. |
howMany | Integer | Jumlah baris yang akan disisipkan. |
Pulang pergi
Sheet
— sheet, berguna untuk perantaian metode
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet()
Menyisipkan lembar baru ke dalam {i>spreadsheet<i}, menggunakan nama {i>sheet<i} default. {i>Sheet baru<i} menjadi {i>active sheet<i}.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet();
Pulang pergi
Sheet
— Sheet baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetIndex)
Menyisipkan sheet baru ke dalam spreadsheet pada indeks tertentu. Sheet baru akan menjadi aktif {i>sheet<i}.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet(1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
sheetIndex | Integer | Indeks sheet yang baru dibuat. Untuk menyisipkan {i>sheet<i} sebagai yang pertama di {i>spreadsheet<i}, tetapkan ke 0. |
Pulang pergi
Sheet
— Sheet baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetIndex, options)
Menyisipkan sheet baru ke dalam spreadsheet pada indeks yang diberikan dan menggunakan opsi lanjutan argumen. Sheet baru akan menjadi sheet aktif.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet(1, {template: templateSheet});
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
sheetIndex | Integer | Indeks sheet yang baru dibuat. Untuk menyisipkan {i>sheet<i} sebagai yang pertama di {i>spreadsheet<i}, 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 dalam spreadsheet, menggunakan nama sheet default dan opsi lanjutan argumen. Sheet baru akan menjadi sheet aktif.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet({template: templateSheet});
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
options | Object | Argumen lanjutan JavaScript opsional, tercantum di bawah ini. |
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 dalam spreadsheet dengan nama tertentu. Sheet baru akan menjadi aktif {i>sheet<i}.
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 lembar baru ke dalam {i>spreadsheet<i} dengan nama yang diberikan pada indeks yang diberikan. Sheet baru menjadi {i>sheet <i}aktif.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet('My New Sheet', 1);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
sheetName | String | Nama sheet baru. |
sheetIndex | Integer | Indeks sheet yang baru dibuat. Untuk menyisipkan {i>sheet<i} sebagai yang pertama di {i>spreadsheet<i}, tetapkan ke 0. |
Pulang pergi
Sheet
— Sheet baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName, sheetIndex, options)
Menyisipkan lembar baru ke dalam {i>spreadsheet<i} dengan nama yang diberikan pada indeks yang diberikan dan menggunakan argumen lanjutan opsional. Sheet baru akan menjadi sheet aktif.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', 1, {template: templateSheet});
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
sheetName | String | Nama sheet baru. |
sheetIndex | Integer | Indeks sheet yang baru disisipkan. Untuk menyisipkan {i>sheet<i} sebagai yang pertama di {i>spreadsheet<i}, 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 dalam spreadsheet dengan nama tertentu dan menggunakan opsi lanjutan argumen. Sheet baru akan menjadi sheet aktif.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', {template: templateSheet});
Parameter
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
keseluruhan {i>sheet<i} dengan spesifikasi sumber data yang diberikan, dan memulai eksekusi data. Sebagai sisi
, menjadikan lembar baru sebagai lembar aktif.
Menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Menggunakan metode SpreadsheetApp#enable...Execution()
untuk mengaktifkan eksekusi data bagi sumber data tertentu
.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds a sheet and sets cell A1 as the parameter cell. const parameterCell = ss.insertSheet('parameterSheet').getRange('A1'); // Sets the value of the parameter cell to 'Duke'. parameterCell.setValue('Duke'); const query = 'select * from `bigquery-public-data`.`ncaa_basketball`.' + '`mbb_historical_tournament_games` WHERE win_school_ncaa = @SCHOOL'; // Adds a data source with a query parameter. // TODO(developer): Update the project ID to your own Google Cloud project ID. const dataSourceSpec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('project-id-1') .setRawQuery(query) .setParameterFromCell('SCHOOL', 'parameterSheet!A1') .build(); // Adds sheets for the data source and data source table to the spreadsheet. ss.insertSheetWithDataSourceTable(dataSourceSpec);
Parameter
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 yang ditentukan 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.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Activates iterative calculation on the spreadsheet. ss.setIterativeCalculationEnabled(true); // Logs whether iterative calculation is activated for the spreadsheet. console.log(ss.isIterativeCalculationEnabled());
Pulang pergi
Boolean
— true
jika penghitungan berulang diaktifkan, false
jika tidak.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByFilter(rowPosition)
Menampilkan apakah baris yang ditentukan disembunyikan oleh filter (bukan tampilan filter).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
Parameter
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 yang ditentukan 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 yang ditentukan dalam daftar sheet. Menampilkan pengecualian jika posisi tersebut negatif atau lebih besar dari jumlah lembar.
// This example assumes that there are 2 sheets in the current // active spreadsheet: one named "first" in position 1 and another named "second" // in position 2. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Gets the "first" sheet and activates it. var sheet = spreadsheet.getSheetByName("first").activate(); // Logs 'Current index of sheet: 1' console.log("Current index of sheet: %s", sheet.getIndex()); spreadsheet.moveActiveSheet(2); // Logs 'New index of sheet: 2' console.log("New index of sheet: %s", sheet.getIndex());
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
pos | Integer | Posisi 1-indeks untuk memindahkan sheet aktif dalam daftar sheet. |
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveChartToObjectSheet(chart)
Membuat sheet SheetType.OBJECT
baru dan memindahkan diagram yang disediakan ke sheet tersebut. Jika diagram
sudah ada di {i>sheet<i} sendiri, {i>sheet<i} tersebut dikembalikan tanpa membuat yang baru.
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.newChart().setPosition(1, 1, 0, 0).build(); sheet.insertChart(chart); var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);
Parameter
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 data tertaut, serta melewati nilai yang tidak valid objek sumber data.
Gunakan metode SpreadsheetApp#enable...Execution()
untuk mengaktifkan eksekusi data untuk
jenis sumber data tertentu.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the first data source sheet on the spreadsheet. const dataSheet = ss.getDataSourceSheets()[0]; // Refreshes all data sources on the spreadsheet. ss.refreshAllDataSources(); // Logs the last refreshed time of the first data source sheet. console.log(`Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`);
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeEditor(emailAddress)
Menghapus pengguna tertentu dari daftar editor untuk Spreadsheet
. Metode ini tidak
blokir pengguna agar tidak mengakses Spreadsheet
jika mereka termasuk dalam kelas pengguna yang telah
akses umum—misalnya, jika Spreadsheet
dibagikan ke seluruh isi pengguna
domain publik, atau jika Spreadsheet
berada di drive bersama yang dapat diakses pengguna.
Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar pelihat.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan dihapus. |
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
removeEditor(user)
Menghapus pengguna tertentu dari daftar editor untuk Spreadsheet
. Metode ini tidak
blokir pengguna agar tidak mengakses Spreadsheet
jika mereka termasuk dalam kelas pengguna yang telah
akses umum—misalnya, jika Spreadsheet
dibagikan ke seluruh isi pengguna
domain publik, atau jika Spreadsheet
berada di drive bersama yang dapat diakses pengguna.
Untuk file Drive, tindakan ini juga akan menghapus pengguna dari daftar pelihat.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan dihapus. |
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
removeMenu(name)
Menghapus menu yang ditambahkan oleh addMenu(name, subMenus)
. Argumen name
harus memiliki nilai yang sama dengan panggilan yang sesuai ke addMenu(name, subMenus)
.
// The onOpen function is