Membuat, mengakses, dan mengubah rentang bernama dalam spreadsheet. Rentang bernama adalah rentang yang memiliki alias string terkait. Rentang tersebut dapat dilihat dan diedit melalui UI Spreadsheet pada menu Data > Rentang bernama....
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
get | String | Mendapatkan nama rentang bernama ini. |
get | Range | Mendapatkan rentang yang dirujuk oleh rentang bernama ini. |
remove() | void | Menghapus rentang bernama ini. |
set | Named | Menetapkan/memperbarui nama rentang bernama. |
set | Named | Menetapkan/memperbarui rentang untuk rentang bernama ini. |
Dokumentasi mendetail
get Name()
Mendapatkan nama rentang bernama ini.
Pulang pergi
String
— nama rentang bernama 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
get Range()
Mendapatkan rentang yang dirujuk oleh rentang bernama ini.
Pulang pergi
Range
— rentang spreadsheet yang dikaitkan dengan rentang bernama 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
remove()
Menghapus rentang bernama ini.
// The code below deletes all the named ranges in the spreadsheet. const namedRanges = SpreadsheetApp.getActive().getNamedRanges(); for (let i = 0; i < namedRanges.length; i++) { namedRanges[i].remove(); }
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Name(name)
Menetapkan/memperbarui nama rentang bernama.
// The code below updates the name for the first named range. const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); if (namedRanges.length > 1) { namedRanges[0].setName('UpdatedNamedRange'); }
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | Nama baru rentang bernama. |
Pulang pergi
Named
— rentang yang namanya ditetapkan oleh panggilan
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Range(range)
Menetapkan/memperbarui rentang untuk rentang bernama ini.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
range | Range | Rentang spreadsheet yang akan dikaitkan dengan rentang bernama ini. |
Pulang pergi
Named
— rentang bernama yang rentang spreadsheet-nya 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