สร้าง เข้าถึง และแก้ไขช่วงที่ตั้งชื่อในสเปรดชีต ช่วงที่ตั้งชื่อแล้วคือช่วงที่มีอลิแอสสตริงที่เชื่อมโยง โดยดูและแก้ไขได้ผ่าน UI ของชีตในเมนูข้อมูล > ช่วงนี้ที่มีชื่อ...
เมธอด
| วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ | 
|---|---|---|
| get | String | รับชื่อของช่วงที่มีชื่อนี้ | 
| get | Range | รับช่วงที่อ้างอิงโดยช่วงที่มีชื่อนี้ | 
| remove() | void | ลบช่วงที่มีชื่อนี้ | 
| set | Named | ตั้งค่า/อัปเดตชื่อของช่วงที่มีชื่อ | 
| set | Named | ตั้งค่า/อัปเดตช่วงสําหรับช่วงที่มีชื่อนี้ | 
เอกสารประกอบโดยละเอียด
get
รับชื่อของช่วงที่มีชื่อนี้
รีเทิร์น
String — ชื่อของช่วงที่มีชื่อนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets
get
remove()
ลบช่วงที่มีชื่อนี้
// 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(); }
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets
set
ตั้งค่า/อัปเดตชื่อของช่วงที่มีชื่อ
// The code below updates the name for the first named range. const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); if (namedRanges.length > 1) { namedRanges[0].setName('UpdatedNamedRange'); }
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย | 
|---|---|---|
| name | String | ชื่อใหม่ของช่วงที่มีชื่อ | 
รีเทิร์น
Named — ช่วงที่ชื่อได้รับการตั้งค่าโดยการเรียกใช้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets
set
ตั้งค่า/อัปเดตช่วงสําหรับช่วงที่มีชื่อนี้
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย | 
|---|---|---|
| range | Range | ช่วงของสเปรดชีตที่จะเชื่อมโยงกับช่วงที่มีชื่อนี้ | 
รีเทิร์น
Named — ช่วงที่มีชื่อซึ่งตั้งค่าช่วงสเปรดชีตไว้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
- 
https://www.googleapis.com/auth/spreadsheets.currentonly
- 
https://www.googleapis.com/auth/spreadsheets