Mengakses dan membuat file Google Spreadsheet. Class ini adalah class induk untuk layanan Spreadsheet.
Properti
Properti | Jenis | Deskripsi |
---|---|---|
AutoFillSeries | AutoFillSeries | Enumerasi jenis deret yang digunakan untuk menghitung nilai yang terisi secara otomatis. |
BandingTheme | BandingTheme | Enumerasi kemungkinan tema garis berwarna. |
BooleanCriteria | BooleanCriteria | Enumerasi kriteria boolean pemformatan bersyarat. |
BorderStyle | BorderStyle | Enumerasi gaya yang valid untuk menetapkan batas pada Range . |
ColorType | ColorType | Enumerasi kemungkinan jenis warna. |
CopyPasteType | CopyPasteType | Enumerasi kemungkinan jenis tempelan. |
DataExecutionErrorCode | DataExecutionErrorCode | Enumerasi kemungkinan kode error eksekusi data. |
DataExecutionState | DataExecutionState | Enumerasi kemungkinan status eksekusi data. |
DataSourceParameterType | DataSourceParameterType | Enumerasi jenis parameter sumber data yang mungkin. |
DataSourceRefreshScope | DataSourceRefreshScope | Enumerasi kemungkinan cakupan pembaruan sumber data. |
DataSourceType | DataSourceType | Enumerasi kemungkinan jenis sumber data. |
DataValidationCriteria | DataValidationCriteria | Enumerasi yang mewakili kriteria validasi data yang dapat ditetapkan pada rentang. |
DateTimeGroupingRuleType | DateTimeGroupingRuleType | Enumerasi aturan pengelompokan tanggal dan waktu. |
DeveloperMetadataLocationType | DeveloperMetadataLocationType | Enumerasi kemungkinan jenis lokasi metadata developer. |
DeveloperMetadataVisibility | DeveloperMetadataVisibility | Enumerasi kemungkinan visibilitas metadata developer. |
Dimension | Dimension | Enumerasi kemungkinan dimensi {i>spreadsheet<i}. |
Direction | Direction | Enumerasi kemungkinan rute yang dapat dipindahkan dalam spreadsheet menggunakan tombol panah. |
FrequencyType | FrequencyType | Enumerasi kemungkinan jenis frekuensi. |
GroupControlTogglePosition | GroupControlTogglePosition | Enumerasi posisi yang dapat diisi oleh tombol kontrol grup. |
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 menampilkan nilai pivot. |
ProtectionType | ProtectionType | Enumerasi yang mewakili bagian-bagian {i>spreadsheet<i} yang dapat dilindungi dari hasil edit. |
RecalculationInterval | RecalculationInterval | Enumerasi kemungkinan interval yang dapat digunakan dalam penghitungan ulang spreadsheet. |
RelativeDate | RelativeDate | Enumerasi opsi tanggal relatif untuk menghitung nilai yang akan digunakan di BooleanCriteria berbasis tanggal. |
SheetType | SheetType | Enumerasi berbagai jenis sheet yang mungkin ada di spreadsheet. |
SortOrder | SortOrder | Enumerasi tata urutan. |
TextDirection | TextDirection | Enumerasi arah teks yang valid. |
TextToColumnsDelimiter | TextToColumnsDelimiter | Enumerasi pemisah preset untuk memisahkan teks ke kolom. |
ThemeColorType | ThemeColorType | Enumerasi kemungkinan jenis warna tema. |
ValueType | ValueType | Enumerasi jenis nilai yang ditampilkan oleh Range.getValue() dan Range.getValues() dari class Range layanan Spreadsheet. Nilai enumerasi yang tercantum di bawah adalah selain 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 tertentu. |
create(name, rows, columns) | Spreadsheet | Membuat spreadsheet baru dengan nama yang diberikan serta 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 sedang 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 sedang aktif, atau null jika tidak ada. |
getCurrentCell() | Range | Menampilkan sel saat ini (ditandai) yang dipilih di salah satu rentang aktif di
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 dengan ID yang diberikan. |
openByUrl(url) | Spreadsheet | Membuka spreadsheet dengan URL yang ditentukan. |
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 di 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 tertentu.
// The code below creates a new spreadsheet "Finances" and logs the URL for it var ssNew = SpreadsheetApp.create("Finances"); Logger.log(ssNew.getUrl());
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | Nama untuk {i>spreadsheet<i}. |
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 serta 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
Nama | Jenis | Deskripsi |
---|---|---|
name | String | Nama untuk {i>spreadsheet<i}. |
rows | Integer | Jumlah baris untuk {i>spreadsheet<i}. |
columns | Integer | Jumlah kolom untuk {i>spreadsheet<i}. |
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 menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode ini untuk mengaktifkan eksekusi data bagi semua jenis sumber data.
// Turns data execution on for all types of data sources. SpreadsheetApp.enableAllDataSourcesExecution(); // 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 the first data source sheet in the spreadsheet and refreshes the data. ss.getDataSourceSheets()[0].refreshData();
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.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // 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 the first data source sheet in the spreadsheet and refreshes the BigQuery data. ss.getDataSourceSheets()[0].refreshData();
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 dibuat, 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 sedang 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 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 menampilkan rentang terakhir yang dipilih.
Secara umum, rentang ini berarti rentang yang telah dipilih pengguna di sheet aktif. Namun, dalam fungsi kustom, rentang ini mengacu pada sel yang secara aktif dihitung ulang.
// 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 saat ini disorot akan ditempatkan terakhir dalam daftar.
Jika ada satu rentang 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 Sheet aktif
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveSpreadsheet()
Menampilkan spreadsheet yang sedang 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 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 (ditandai) yang dipilih di salah satu rentang aktif di
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 mengetahui 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()
Membuat builder untuk CellImage
.
// 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 Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A1 on Sheet1. const range = sheet.getRange('A1'); // Builds an image using a source URL. const cellImage = SpreadsheetApp.newCellImage() .setSourceUrl('https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png') .build(); // Sets the image in cell A1. range.setValue(cellImage);
Return
CellImageBuilder
— Builder baru.
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()
Membuat builder untuk DataSourceSpec
.
// 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'); // Enables BigQuery. SpreadsheetApp.enableBigQueryExecution(); // 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);
Return
DataSourceSpecBuilder
— Builder baru.
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()
Membuat builder untuk FilterCriteria
.
// 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 Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets the range to A1:D20. const range = sheet.getRange('A1:D20'); // Creates a filter and applies it to the specified range. range.createFilter(); // Gets the current filter for the range and creates filter criteria that only shows cells // that aren't empty. const filter = range.getFilter(); const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build(); // Sets the criteria to column C. filter.setColumnFilterCriteria(3, criteria);
Return
FilterCriteriaBuilder
— builder baru
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
Nama | 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 dengan 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
Nama | 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 ditentukan. Menampilkan pengecualian pembuatan skrip jika URL tidak ada atau pengguna tidak memiliki izin untuk mengaksesnya.
// Opens a spreadsheet by its URL and logs its name. // Note that the spreadsheet doesn't physically open on the client side. // It opens on the server only (for modification by the script). var ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc1234567/edit'); console.log(ss.getName());
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
url | String | URL untuk spreadsheet. |
Return
Spreadsheet
— Objek spreadsheet dengan URL 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
Nama | Jenis | Deskripsi |
---|---|---|
range | Range | Rentang yang akan dijadikan rentang aktif. |
Return
Range
— Rentang aktif baru
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
Nama | Jenis | Deskripsi |
---|---|---|
rangeList | RangeList | Daftar rentang yang dapat 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 di spreadsheet. UI Google Spreadsheet menampilkan sheet yang dipilih kecuali jika sheet tersebut milik spreadsheet lain.
// The code below makes the 2nd sheet active in the active spreadsheet. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); SpreadsheetApp.setActiveSheet(spreadsheet.getSheets()[1]);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
sheet | Sheet | Sheet aktif baru. |
Return
Sheet
— sheet yang telah dijadikan 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 tersebut milik spreadsheet berbeda.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var firstSheet = spreadsheet.getSheets()[0]; var secondSheet = spreadsheet.getSheets()[1]; // Set the first sheet as the active sheet and select the range D4:F4. spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate(); // Switch to the second sheet to do some work. spreadsheet.setActiveSheet(secondSheet); // Switch back to first sheet, and restore its selection. spreadsheet.setActiveSheet(firstSheet, true); // The selection of first sheet is restored, and it logs D4:F4 var range = spreadsheet.getActiveSheet().getSelection().getActiveRange(); Logger.log(range.getA1Notation());
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
sheet | Sheet | Sheet aktif baru. |
restoreSelection | Boolean | Jika true , pilihan terbaru dari sheet aktif baru
akan dipilih lagi saat sheet baru menjadi aktif; jika false , sheet baru
akan 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
Nama | Jenis | Deskripsi |
---|---|---|
newActiveSpreadsheet | Spreadsheet | {i>Spreadsheet<i} yang akan dijadikan sebagai {i>spreadsheet<i} aktif. |
setCurrentCell(cell)
Menetapkan sel yang ditentukan sebagai current cell
.
Jika sel yang ditentukan ada dalam rentang yang sudah dipilih, rentang tersebut akan menjadi rentang aktif dengan sel sebagai sel saat ini.
Jika sel yang ditentukan tidak ada dalam rentang yang dipilih, pilihan yang ada akan dihapus dan sel tersebut akan menjadi sel saat ini dan rentang yang 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
Nama | Jenis | Deskripsi |
---|---|---|
cell | Range | Sel yang akan ditetapkan sebagai sel saat ini. |
Return
Range
— sel saat ini yang baru ditetapkan
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets