Class NamedRange

NamedRange

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

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getName()StringMendapatkan nama rentang bernama ini.
getRange()RangeMendapatkan rentang yang direferensikan oleh rentang bernama ini.
remove()voidMenghapus rentang bernama ini.
setName(name)NamedRangeMenetapkan/memperbarui nama rentang bernama.
setRange(range)NamedRangeMenetapkan/memperbarui rentang untuk rentang bernama ini.

Dokumentasi mendetail

getName()

Mendapatkan nama rentang bernama ini.

Return

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 direferensikan oleh rentang bernama ini.

Return

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.
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

NamaJenisDeskripsi
nameStringNama baru rentang bernama.

Return

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

NamaJenisDeskripsi
rangeRangeRentang spreadsheet yang akan dikaitkan dengan rentang bernama ini.

Return

NamedRange — rentang bernama yang digunakan untuk menetapkan rentang 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