Class NamedRange

Rentang Bernama

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getName()StringMendapatkan nama rentang bernama ini.
getRange()RangeMendapatkan rentang yang dirujuk 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.

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

setName(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

NamaJenisDeskripsi
nameStringNama baru 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

NamaJenisDeskripsi
rangeRangeRentang spreadsheet yang akan dikaitkan dengan rentang bernama ini.

Pulang pergi

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