Range yang memiliki nama dan ID untuk memungkinkan pengambilan nanti. Nama bukan
harus unik; beberapa rentang berbeda di tab yang sama mungkin memiliki nama yang sama, mirip seperti
di HTML. Sebaliknya, ID bersifat unik dalam tab, seperti ID di HTML. Setelah NamedRange ditambahkan ke tab, Anda tidak dapat mengubahnya, hanya dapat dihapus.
NamedRange dapat diakses oleh skrip apa pun yang mengakses tab. Untuk menghindari hal yang tidak diinginkan
konflik antar skrip, pertimbangkan untuk memberi awalan pada nama rentang dengan string unik.
// Create a named range that includes every table in the active tab.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var 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 bersifat unik dalam tab.
Pulang pergi
String — ID rentang, yang unik dalam tab.
getName()
Mendapatkan nama NamedRange ini. Nama belum tentu unik.
Pulang pergi
String — Nama rentang, yang belum tentu 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 isi
{i>range<i}; hanya akan menghapus referensi. Memanggil metode ini di NamedRange yang
telah dihapus tidak 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