Mengakses dan membuat file Google Spreadsheet. Class ini adalah class induk untuk layanan Spreadsheet.
Properti
Properti | Jenis | Deskripsi |
---|---|---|
AutoFillSeries | AutoFillSeries | Enumerasi jenis rangkaian yang digunakan untuk menghitung nilai yang diisi otomatis. |
BandingTheme | BandingTheme | Enumerasi kemungkinan tema banding. |
BooleanCriteria | BooleanCriteria | Enumerasi kriteria boolean format bersyarat. |
BorderStyle | BorderStyle | Enumerasi gaya yang valid untuk menetapkan batas pada Range . |
ColorType | ColorType | Enumerasi jenis warna yang memungkinkan. |
CopyPasteType | CopyPasteType | Enumerasi jenis tempel yang mungkin. |
DataExecutionErrorCode | DataExecutionErrorCode | Enumerasi kemungkinan kode error eksekusi data. |
DataExecutionState | DataExecutionState | Enumerasi kemungkinan status eksekusi data. |
DataSourceParameterType | DataSourceParameterType | Enumerasi jenis parameter sumber data yang memungkinkan. |
DataSourceRefreshScope | DataSourceRefreshScope | Enumerasi kemungkinan cakupan pembaruan sumber data. |
DataSourceType | DataSourceType | Enumerasi dari kemungkinan jenis sumber data. |
DataValidationCriteria | DataValidationCriteria | Enumerasi yang mewakili kriteria validasi data yang dapat ditetapkan pada rentang. |
DateTimeGroupingRuleType | DateTimeGroupingRuleType | Enumerasi aturan pengelompokan waktu tanggal. |
DeveloperMetadataLocationType | DeveloperMetadataLocationType | Enumerasi kemungkinan jenis lokasi metadata developer. |
DeveloperMetadataVisibility | DeveloperMetadataVisibility | Enumerasi kemungkinan visibilitas metadata developer. |
Dimension | Dimension | Enumerasi kemungkinan dimensi spreadsheet. |
Direction | Direction | Enumerasi kemungkinan rute yang dapat dipindahkan dalam spreadsheet menggunakan tombol panah. |
FrequencyType | FrequencyType | Enumerasi jenis frekuensi yang mungkin. |
GroupControlTogglePosition | GroupControlTogglePosition | Enumerasi posisi tempat tombol beralih grup dapat berada. |
InterpolationType | InterpolationType | Enumerasi jenis interpolasi gradien format bersyarat. |
PivotTableSummarizeFunction | PivotTableSummarizeFunction | Enumerasi fungsi yang dapat digunakan untuk meringkas nilai dalam tabel pivot. |
PivotValueDisplayType | PivotValueDisplayType | Enumerasi cara nilai pivot dapat ditampilkan. |
ProtectionType | ProtectionType | Enumerasi yang mewakili bagian spreadsheet yang dapat dilindungi dari pengeditan. |
RecalculationInterval | RecalculationInterval | Enumerasi kemungkinan interval yang dapat digunakan dalam penghitungan ulang spreadsheet. |
RelativeDate | RelativeDate | Enumerasi opsi tanggal relatif untuk menghitung nilai yang akan digunakan dalam BooleanCriteria berbasis tanggal. |
SheetType | SheetType | Enumerasi dari berbagai jenis sheet yang dapat ada di spreadsheet. |
SortOrder | SortOrder | Enumerasi tata urutan. |
TextDirection | TextDirection | Enumerasi rute teks yang valid. |
TextToColumnsDelimiter | TextToColumnsDelimiter | Enumerasi pembatas preset untuk teks terpisah menjadi kolom. |
ThemeColorType | ThemeColorType | Enumerasi kemungkinan jenis warna tema. |
ValueType | ValueType | Enumerasi jenis nilai yang ditampilkan oleh Range.getValue() dan Range.getValues() dari class Rentang layanan Spreadsheet. Nilai enumerasi yang tercantum di bawah adalah tambahan untuk Number , Boolean , Date , atau String . |
WrapStrategy | WrapStrategy | Enumerasi strategi yang digunakan untuk menggabungkan sel. |
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
create(name) | Spreadsheet | Membuat spreadsheet baru dengan nama yang diberikan. |
create(name, rows, columns) | Spreadsheet | Membuat spreadsheet baru dengan nama yang diberikan dan jumlah baris dan kolom yang ditentukan. |
enableAllDataSourcesExecution() | void | Mengaktifkan eksekusi data untuk semua jenis sumber data. |
enableBigQueryExecution() | void | Mengaktifkan eksekusi data untuk sumber data BigQuery. |
flush() | void | Menerapkan semua perubahan Spreadsheet yang tertunda. |
getActive() | Spreadsheet | Menampilkan spreadsheet yang saat ini aktif, atau null jika tidak ada. |
getActiveRange() | Range | Menampilkan rentang yang dipilih di sheet aktif, atau null jika tidak ada rentang aktif. |
getActiveRangeList() | RangeList | Menampilkan daftar rentang aktif di sheet aktif atau null jika tidak ada rentang yang dipilih. |
getActiveSheet() | Sheet | Mendapatkan sheet aktif dalam spreadsheet. |
getActiveSpreadsheet() | Spreadsheet | Menampilkan spreadsheet yang saat ini aktif, atau null jika tidak ada. |
getCurrentCell() | Range | Menampilkan sel saat ini (yang ditandai) yang dipilih dalam salah satu rentang aktif dalam
sheet aktif atau null jika tidak ada sel saat ini. |
getSelection() | Selection | Menampilkan Selection saat ini di spreadsheet. |
getUi() | Ui | Menampilkan instance lingkungan antarmuka pengguna spreadsheet yang memungkinkan skrip untuk menambahkan fitur seperti menu, dialog, dan sidebar. |
newCellImage() | CellImageBuilder | Membuat builder untuk CellImage . |
newColor() | ColorBuilder | Membuat builder untuk Color . |
newConditionalFormatRule() | ConditionalFormatRuleBuilder | Membuat builder untuk aturan format bersyarat. |
newDataSourceSpec() | DataSourceSpecBuilder | Membuat builder untuk DataSourceSpec . |
newDataValidation() | DataValidationBuilder | Membuat builder untuk aturan validasi data. |
newFilterCriteria() | FilterCriteriaBuilder | Membuat builder untuk FilterCriteria . |
newRichTextValue() | RichTextValueBuilder | Membuat builder untuk nilai Rich Text. |
newTextStyle() | TextStyleBuilder | Membuat builder untuk gaya teks. |
open(file) | Spreadsheet | Membuka spreadsheet yang sesuai dengan objek File yang diberikan. |
openById(id) | Spreadsheet | Membuka spreadsheet yang berisi ID yang diberikan. |
openByUrl(url) | Spreadsheet | Membuka spreadsheet dengan URL yang diberikan. |
setActiveRange(range) | Range | Menetapkan rentang yang ditentukan sebagai active range , dengan sel kiri atas dalam rentang sebagai current cell . |
setActiveRangeList(rangeList) | RangeList | Menetapkan daftar rentang yang ditentukan sebagai active ranges . |
setActiveSheet(sheet) | Sheet | Menetapkan sheet aktif dalam spreadsheet. |
setActiveSheet(sheet, restoreSelection) | Sheet | Menetapkan sheet aktif dalam spreadsheet, dengan opsi untuk memulihkan pilihan terbaru dalam sheet tersebut. |
setActiveSpreadsheet(newActiveSpreadsheet) | void | Menetapkan spreadsheet aktif. |
setCurrentCell(cell) | Range | Menetapkan sel yang ditentukan sebagai current cell . |
Dokumentasi mendetail
create(name)
Membuat spreadsheet baru dengan nama yang diberikan.
// The code below creates a new spreadsheet "Finances" and logs the URL for it var ssNew = SpreadsheetApp.create("Finances"); Logger.log(ssNew.getUrl());
Parameter
Name | Jenis | Deskripsi |
---|---|---|
name | String | Nama spreadsheet. |
Return
Spreadsheet
— spreadsheet baru
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets
create(name, rows, columns)
Membuat spreadsheet baru dengan nama yang diberikan dan jumlah baris dan kolom yang ditentukan.
// The code below creates a new spreadsheet "Finances" with 50 rows and 5 columns and logs the // URL for it var ssNew = SpreadsheetApp.create("Finances", 50, 5); Logger.log(ssNew.getUrl());
Parameter
Name | Jenis | Deskripsi |
---|---|---|
name | String | Nama spreadsheet. |
rows | Integer | Jumlah baris untuk spreadsheet. |
columns | Integer | Jumlah kolom untuk spreadsheet. |
Return
Spreadsheet
— spreadsheet baru
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets
enableAllDataSourcesExecution()
Mengaktifkan eksekusi data untuk semua jenis sumber data.
Eksekusi data akan menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode ini untuk mengaktifkan eksekusi data untuk semua jenis sumber data.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/bigquery.readonly
enableBigQueryExecution()
Mengaktifkan eksekusi data untuk sumber data BigQuery.
Eksekusi data untuk sumber data BigQuery akan menampilkan pengecualian jika tidak diaktifkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/bigquery.readonly
flush()
Menerapkan semua perubahan Spreadsheet yang tertunda.
Operasi spreadsheet terkadang dipaketkan bersama untuk meningkatkan performa, seperti saat melakukan beberapa panggilan ke Range.getValue(). Namun, terkadang Anda mungkin ingin memastikan bahwa semua perubahan yang tertunda segera dilakukan, misalnya untuk menampilkan data pengguna saat skrip dieksekusi.
// The code below changes the background color of cells A1 and B1 twenty times. You should be // able to see the updates live in the spreadsheet. If flush() is not called, the updates may // be applied live or may all be applied at once when the script completes. function colors() { var sheet = SpreadsheetApp.getActiveSheet(); for (var i = 0; i < 20; i++) { if ((i % 2) == 0) { sheet.getRange('A1').setBackground('green'); sheet.getRange('B1').setBackground('red'); } else { sheet.getRange('A1').setBackground('red'); sheet.getRange('B1').setBackground('green'); } SpreadsheetApp.flush(); } }
getActive()
Menampilkan spreadsheet yang saat ini aktif, atau null
jika tidak ada.
Fungsi yang dijalankan dalam konteks spreadsheet bisa mendapatkan referensi ke objek Spreadsheet yang sesuai dengan memanggil fungsi ini.
// The code below logs the URL for the active spreadsheet. Logger.log(SpreadsheetApp.getActive().getUrl());
Return
Spreadsheet
— objek Spreadsheet 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
getActiveRange()
Menampilkan rentang yang dipilih di sheet aktif, atau null
jika tidak ada rentang aktif. Jika beberapa rentang dipilih, metode ini hanya akan menampilkan rentang terakhir yang dipilih.
Secara umum, ini berarti rentang yang dipilih pengguna dalam sheet aktif, tetapi dalam fungsi kustom, rentang ini merujuk pada sel yang dihitung ulang secara aktif.
// The code below logs the background color for the active range. var colorObject = SpreadsheetApp.getActiveRange().getBackgroundObject(); // Assume the color has ColorType.RGB. Logger.log(colorObject.asRgbColor().asHexString());
Return
Range
— Rentang aktif.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveRangeList()
Menampilkan daftar rentang aktif di sheet aktif atau null
jika tidak ada rentang yang dipilih. Rentang aktif yang berisi sel yang disorot saat ini ditempatkan terakhir dalam daftar.
Jika ada rentang tunggal yang dipilih, ini akan berperilaku sebagai panggilan getActiveRange()
.
// Returns the list of active ranges. var rangeList = SpreadsheetApp.getActiveRangeList();
Return
RangeList
— daftar rentang aktif
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveSheet()
Mendapatkan sheet aktif dalam spreadsheet.
Sheet aktif dalam spreadsheet adalah sheet yang ditampilkan di UI spreadsheet.
// The code below logs the name of the active sheet. Logger.log(SpreadsheetApp.getActiveSheet().getName());
Return
Sheet
— objek Spreadsheet 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
getActiveSpreadsheet()
Menampilkan spreadsheet yang saat ini aktif, atau null
jika tidak ada.
Fungsi yang dijalankan dalam konteks spreadsheet bisa mendapatkan referensi ke objek Spreadsheet
yang sesuai dengan memanggil fungsi ini.
// The code below logs the URL for the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getUrl());
Return
Spreadsheet
— objek Spreadsheet 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
getCurrentCell()
Menampilkan sel saat ini (yang ditandai) yang dipilih dalam salah satu rentang aktif dalam
sheet aktif atau null
jika tidak ada sel saat ini.
// Returns the current highlighted cell in the one of the active ranges. var currentCell = SpreadsheetApp.getCurrentCell();
Return
Range
— sel saat ini
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
Menampilkan Selection
saat ini di spreadsheet.
var selection = SpreadsheetApp.getSelection(); var currentCell = selection.getCurrentCell();
Return
Selection
— pilihan saat ini
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getUi()
Menampilkan instance lingkungan antarmuka pengguna spreadsheet yang memungkinkan skrip untuk menambahkan fitur seperti menu, dialog, dan sidebar. Skrip hanya dapat berinteraksi dengan UI untuk instance spreadsheet terbuka saat ini, dan hanya jika skrip terikat ke spreadsheet. Untuk informasi selengkapnya, lihat panduan untuk menu serta dialog dan sidebar.
// Add a custom menu to the active spreadsheet, including a separator and a sub-menu. function onOpen(e) { SpreadsheetApp.getUi() .createMenu('My Menu') .addItem('My menu item', 'myFunction') .addSeparator() .addSubMenu(SpreadsheetApp.getUi().createMenu('My sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction')) .addToUi(); }
Return
Ui
— instance lingkungan antarmuka pengguna spreadsheet ini
newCellImage()
newColor()
Membuat builder untuk Color
.
var rgbColor = SpreadsheetApp.newColor().setRgbColor("#FF0000").build();
Return
ColorBuilder
— Builder baru.
newConditionalFormatRule()
Membuat builder untuk aturan format bersyarat.
// Adds a conditional format rule to a sheet that causes all cells in range A1:B3 to turn red // if they contain a number between 1 and 10. var sheet = SpreadsheetApp.getActive().getActiveSheet(); var range = sheet.getRange('A1:B3'); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground("#FF0000") .setRanges([range]) .build() var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Return
ConditionalFormatRuleBuilder
— builder baru.
newDataSourceSpec()
newDataValidation()
Membuat builder untuk aturan validasi data.
var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireNumberBetween(1, 100) .setAllowInvalid(false) .setHelpText('Number must be between 1 and 100.') .build(); cell.setDataValidation(rule);
Return
DataValidationBuilder
— Builder baru.
newFilterCriteria()
newRichTextValue()
Membuat builder untuk nilai Rich Text.
// Sets cell A1 to have the text "Hello world", with "Hello" bolded. var cell = SpreadsheetApp.getActive().getRange('A1'); var bold = SpreadsheetApp.newTextStyle().setBold(true).build(); var value = SpreadsheetApp.newRichTextValue() .setText("Hello world") .setTextStyle(0, 5, bold) .build(); cell.setRichTextValue(value);
Return
RichTextValueBuilder
— Builder baru.
newTextStyle()
Membuat builder untuk gaya teks.
// Sets range A1:B3 to have red, size 22, bolded, underlined text. var range = SpreadsheetApp.getActive().getRange('A1:B3'); var style = SpreadsheetApp.newTextStyle() .setForegroundColor("red") .setFontSize(22) .setBold(true) .setUnderline(true) .build(); range.setTextStyle(style);
Return
TextStyleBuilder
— Builder baru.
open(file)
Membuka spreadsheet yang sesuai dengan objek File yang diberikan.
// Get any starred spreadsheets from Google Drive, then open the spreadsheets and log the name // of the first sheet within each spreadsheet. var files = DriveApp.searchFiles( 'starred = true and mimeType = "' + MimeType.GOOGLE_SHEETS + '"'); while (files.hasNext()) { var spreadsheet = SpreadsheetApp.open(files.next()); var sheet = spreadsheet.getSheets()[0]; Logger.log(sheet.getName()); }
Parameter
Name | Jenis | Deskripsi |
---|---|---|
file | File | File yang akan dibuka. |
Return
Spreadsheet
— spreadsheet
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets
openById(id)
Membuka spreadsheet yang berisi ID yang diberikan. 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 opens a spreadsheet using its ID and logs the name for it. // Note that the spreadsheet is NOT physically opened on the client side. // It is opened on the server only (for modification by the script). var ss = SpreadsheetApp.openById("abc1234567"); Logger.log(ss.getName());
Parameter
Name | Jenis | Deskripsi |
---|---|---|
id | String | ID unik untuk spreadsheet. |
Return
Spreadsheet
— objek Spreadsheet dengan id yang diberikan
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets
openByUrl(url)
Membuka spreadsheet dengan URL yang diberikan. Menampilkan pengecualian skrip jika URL tidak ada atau pengguna tidak memiliki izin untuk mengaksesnya.
// The code below opens a spreadsheet using its id and logs the name for it. // Note that the spreadsheet is NOT physically opened on the client side. // It is opened on the server only (for modification by the script). var ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc1234567/edit'); Logger.log(ss.getName());
Parameter
Name | Jenis | Deskripsi |
---|---|---|
url | String | URL untuk spreadsheet tersebut. |
Return
Spreadsheet
— objek Spreadsheet dengan id yang diberikan
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets
setActiveRange(range)
Menetapkan rentang yang ditentukan sebagai active range
, dengan sel kiri atas dalam rentang sebagai current cell
.
UI spreadsheet menampilkan sheet yang berisi rentang yang dipilih dan memilih sel yang ditentukan dalam rentang yang dipilih.
// The code below sets range C1:D4 in the first sheet as the active range. var range = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('C1:D4'); SpreadsheetApp.setActiveRange(range); var selection = SpreadsheetApp.getSelection(); // Current cell: C1 var currentCell = selection.getCurrentCell(); // Active Range: C1:D4 var activeRange = selection.getActiveRange();
Parameter
Name | Jenis | Deskripsi |
---|---|---|
range | Range | Rentang yang akan dibuat rentang aktif. |
Return
Range
— Rentang baru yang aktif
setActiveRangeList(rangeList)
Menetapkan daftar rentang yang ditentukan sebagai active ranges
. Rentang terakhir
dalam daftar ditetapkan sebagai active range
.
// The code below sets ranges [D4, B2:C4] in the active sheet as the active ranges. var rangeList = SpreadsheetApp.getActiveSheet().getRanges(['D4', 'B2:C4']); SpreadsheetApp.setActiveRangeList(rangeList); var selection = SpreadsheetApp.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Parameter
Name | Jenis | Deskripsi |
---|---|---|
rangeList | RangeList | Daftar rentang untuk dipilih. |
Return
RangeList
— daftar rentang yang baru dipilih
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSheet(sheet)
Menetapkan sheet aktif dalam spreadsheet. UI Google Spreadsheet menampilkan sheet yang dipilih, kecuali sheet tersebut termasuk dalam spreadsheet yang berbeda.
// The code below makes the 2nd sheet active in the active spreadsheet. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); SpreadsheetApp.setActiveSheet(spreadsheet.getSheets()[1]);
Parameter
Name | Jenis | Deskripsi |
---|---|---|
sheet | Sheet | Sheet aktif baru. |
Return
Sheet
— sheet yang telah dibuat menjadi sheet aktif baru
setActiveSheet(sheet, restoreSelection)
Menetapkan sheet aktif dalam spreadsheet, dengan opsi untuk memulihkan pilihan terbaru dalam sheet tersebut. UI Google Spreadsheet menampilkan sheet yang dipilih kecuali jika sheet berada di spreadsheet yang berbeda.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var firstSheet = spreadsheet.getSheets()[0]; var secondSheet = spreadsheet.getSheets()[1]; // Set the first sheet as the active sheet and select the range D4:F4. spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate(); // Switch to the second sheet to do some work. spreadsheet.setActiveSheet(secondSheet); // Switch back to first sheet, and restore its selection. spreadsheet.setActiveSheet(firstSheet, true); // The selection of first sheet is restored, and it logs D4:F4 var range = spreadsheet.getActiveSheet().getSelection().getActiveRange(); Logger.log(range.getA1Notation());
Parameter
Name | Jenis | Deskripsi |
---|---|---|
sheet | Sheet | Sheet aktif baru. |
restoreSelection | Boolean | Jika true , pilihan terbaru dari sheet aktif yang baru
akan dipilih lagi saat sheet baru menjadi aktif; jika false , sheet baru
akan menjadi aktif tanpa mengubah pilihan saat ini. |
Return
Sheet
— sheet aktif baru
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSpreadsheet(newActiveSpreadsheet)
Menetapkan spreadsheet aktif.
// The code below makes the spreadsheet with key "1234567890" the active spreadsheet var ss = SpreadsheetApp.openById("1234567890"); SpreadsheetApp.setActiveSpreadsheet(ss);
Parameter
Name | Jenis | Deskripsi |
---|---|---|
newActiveSpreadsheet | Spreadsheet | Spreadsheet yang akan dijadikan spreadsheet aktif. |
setCurrentCell(cell)
Menetapkan sel yang ditentukan sebagai current cell
.
Jika sel yang ditentukan terdapat dalam rentang yang sudah dipilih, rentang tersebut akan menjadi rentang aktif dengan sel sebagai sel saat ini.
Jika sel yang ditentukan tidak ada dalam rentang yang dipilih, pilihan yang ada akan dihapus dan sel akan menjadi sel saat ini dan rentang aktif.
Catatan: Range
yang ditentukan harus terdiri dari satu sel; jika tidak, metode ini
akan menampilkan pengecualian.
// The code below sets the cell B5 in the first sheet as the current cell. var cell = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('B5'); SpreadsheetApp.setCurrentCell(cell); var selection = SpreadsheetApp.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Parameter
Name | Jenis | Deskripsi |
---|---|---|
cell | Range | Sel yang akan ditetapkan sebagai sel saat ini. |
Return
Range
— sel yang baru ditetapkan
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets