Range yang memiliki nama dan ID untuk memungkinkan pengambilan di lain waktu. Nama tidak selalu unik; beberapa rentang yang berbeda pada dokumen yang sama dapat memiliki nama yang sama, seperti halnya class dalam HTML. Sebaliknya, ID bersifat unik dalam dokumen, seperti ID dalam HTML. Setelah ditambahkan ke dokumen, NamedRange tidak dapat diubah, hanya akan dihapus.
NamedRange dapat diakses oleh skrip apa pun yang mengakses dokumen. Untuk menghindari
konflik yang tidak diinginkan antar-skrip, pertimbangkan untuk mengawali nama rentang dengan string unik.
// Create a named range that includes every table in the document.
var doc = DocumentApp.getActiveDocument();
var rangeBuilder = doc.newRange();
var tables = doc.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
rangeBuilder.addElement(tables[i]);
}
doc.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 dokumen. |
Dokumentasi mendetail
getId()
Mendapatkan ID NamedRange ini. ID bersifat unik dalam dokumen.
Return
String — ID rentang yang unik dalam dokumen
getName()
Mendapatkan nama NamedRange ini. Nama ini tidak harus unik.
Return
String — nama rentang, yang tidak selalu 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.
Return
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 dokumen. Metode ini tidak menghapus isi
rentang; metode ini hanya menghapus referensi. Memanggil metode ini pada NamedRange
yang telah 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