Halaman ini diterjemahkan oleh Cloud Translation API.

Class NamedRange

Membuat, mengakses, dan mengubah rentang bernama dalam spreadsheet. Rentang bernama adalah rentang yang memiliki alias string yang terkait. Data tersebut dapat dilihat dan diedit melalui UI Spreadsheet di bagian Data > Rentang bernama....

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`getName()`	`String`	Mendapatkan nama rentang bernama ini.
`getRange()`	`Range`	Mendapatkan rentang yang dirujuk oleh rentang bernama ini.
`remove()`	`void`	Menghapus rentang bernama ini.
`setName(name)`	`NamedRange`	Menetapkan/memperbarui nama rentang bernama.
`setRange(range)`	`NamedRange`	Menetapkan/memperbarui rentang untuk rentang bernama ini.

Dokumentasi mendetail

`getName()`

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

`getRange()`

Mendapatkan rentang yang dirujuk oleh rentang bernama ini.

Pulang pergi

Range — rentang spreadsheet yang terkait 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.
var namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (var 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

`setName(name)`

Menetapkan/memperbarui nama rentang bernama.

// The code below updates the name for the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName("UpdatedNamedRange");
}

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama baru dari rentang bernama.

Pulang pergi

NamedRange — 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

`setRange(range)`

Menetapkan/memperbarui rentang untuk rentang bernama ini.

Parameter

Nama	Jenis	Deskripsi
`range`	`Range`	Rentang spreadsheet untuk dikaitkan dengan rentang bernama ini.

Pulang pergi

NamedRange — rentang bernama yang rentang spreadsheetnya 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