Class NamedRange

Rentang Bernama

Range yang memiliki nama dan ID untuk memungkinkan pengambilan di lain waktu. Nama tidak harus unik; beberapa rentang yang berbeda di tab yang sama dapat memiliki nama yang sama, seperti class di HTML. Sebaliknya, ID bersifat unik dalam tab, seperti ID di HTML. Setelah ditambahkan ke tab, NamedRange tidak dapat diubah, hanya dihapus.

NamedRange dapat diakses oleh skrip apa pun yang mengakses tab. Untuk menghindari konflik yang tidak disengaja antara skrip, pertimbangkan untuk menambahkan awalan nama rentang dengan string unik.

// Create a named range that includes every table in the active tab.
const documentTab =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
getId()	String	Mendapatkan ID NamedRange ini.
getName()	String	Mendapatkan nama NamedRange ini.
getRange()	Range	Mendapatkan rentang elemen yang terkait dengan NamedRange ini.
remove()	void	Menghapus NamedRange ini dari tab.

Dokumentasi mendetail

getId()

Mendapatkan ID NamedRange ini. ID ini unik dalam tab.

Pulang pergi

String — ID rentang, yang unik dalam tab.

---

getName()

Mendapatkan nama NamedRange ini. Nama tidak harus unik.

Pulang pergi

String — Nama rentang, yang tidak harus unik.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

---

getRange()

Mendapatkan rentang elemen yang terkait dengan NamedRange ini.

Pulang pergi

Range — Rentang elemen yang terkait dengan nama dan ID.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents

---

remove()

Menghapus NamedRange ini dari tab. Metode ini tidak menghapus konten rentang; metode ini hanya menghapus referensi. Memanggil metode ini pada NamedRange yang sudah dihapus tidak akan berpengaruh.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

• https://www.googleapis.com/auth/documents.currentonly
• https://www.googleapis.com/auth/documents