Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
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....
// The code below deletes all the named ranges in the spreadsheet.constnamedRanges=SpreadsheetApp.getActive().getNamedRanges();for(leti=0;i < namedRanges.length;i++){namedRanges[i].remove();}
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
// The code below updates the name for the first named range.constnamedRanges=SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();if(namedRanges.length > 1){namedRanges[0].setName('UpdatedNamedRange');}
Parameter
Nama
Jenis
Deskripsi
name
String
Nama 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:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-26 UTC."],[[["\u003cp\u003eNamed ranges provide string aliases for cell ranges within a spreadsheet, enhancing readability and simplifying formulas.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage named ranges through the Sheets UI under "Data > Named ranges..." or programmatically using Apps Script methods.\u003c/p\u003e\n"],["\u003cp\u003eApps Script offers methods to create, access, modify, and delete named ranges, including \u003ccode\u003egetName()\u003c/code\u003e, \u003ccode\u003egetRange()\u003c/code\u003e, \u003ccode\u003eremove()\u003c/code\u003e, \u003ccode\u003esetName()\u003c/code\u003e, and \u003ccode\u003esetRange()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThese methods enable you to retrieve and update the name and range associated with a named range, as well as delete it entirely.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required to utilize these methods, necessitating specific scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/spreadsheets\u003c/code\u003e.\u003c/p\u003e\n"]]],["Named ranges in spreadsheets can be managed using provided methods. You can retrieve a named range's name using `getName()`, or its associated range using `getRange()`. To modify, use `setName(name)` to change the named range's alias and `setRange(range)` to assign it a new range. To delete the range use `remove()`. These actions require spreadsheet authorization scopes. The UI location is in **Data \u003e Named ranges...** menu.\n"],null,["NamedRange\n\nCreate, access and modify named ranges in a spreadsheet. Named ranges are ranges that have\nassociated string aliases. They can be viewed and edited via the Sheets UI under the **Data \\\u003e\nNamed ranges...** menu. \n\nMethods\n\n| Method | Return type | Brief description |\n|-------------------------------------|---------------------------------------------------|------------------------------------------------|\n| [getName()](#getName()) | `String` | Gets the name of this named range. |\n| [getRange()](#getRange()) | [Range](/apps-script/reference/spreadsheet/range) | Gets the range referenced by this named range. |\n| [remove()](#remove()) | `void` | Deletes this named range. |\n| [setName(name)](#setName(String)) | [NamedRange](#) | Sets/updates the name of the named range. |\n| [setRange(range)](#setRange(Range)) | [NamedRange](#) | Sets/updates the range for this named range. |\n\nDetailed documentation \n\n`get``Name()` \nGets the name of this named range.\n\nReturn\n\n\n`String` --- the name of this named range\n\nAuthorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/spreadsheets.currentonly`\n- `https://www.googleapis.com/auth/spreadsheets`\n\n*** ** * ** ***\n\n`get``Range()` \nGets the range referenced by this named range.\n\nReturn\n\n\n[Range](/apps-script/reference/spreadsheet/range) --- the spreadsheet range that is associated with this named range\n\nAuthorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/spreadsheets.currentonly`\n- `https://www.googleapis.com/auth/spreadsheets`\n\n*** ** * ** ***\n\n`remove()` \nDeletes this named range.\n\n```javascript\n// The code below deletes all the named ranges in the spreadsheet.\nconst namedRanges = SpreadsheetApp.getActive().getNamedRanges();\nfor (let i = 0; i \u003c namedRanges.length; i++) {\n namedRanges[i].remove();\n}\n```\n\nAuthorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/spreadsheets.currentonly`\n- `https://www.googleapis.com/auth/spreadsheets`\n\n*** ** * ** ***\n\n`set``Name(name)` \nSets/updates the name of the named range.\n\n```javascript\n// The code below updates the name for the first named range.\nconst namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();\nif (namedRanges.length \u003e 1) {\n namedRanges[0].setName('UpdatedNamedRange');\n}\n```\n\nParameters\n\n| Name | Type | Description |\n|--------|----------|----------------------------------|\n| `name` | `String` | The new name of the named range. |\n\nReturn\n\n\n[NamedRange](#) --- the range whose name was set by the call\n\nAuthorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/spreadsheets.currentonly`\n- `https://www.googleapis.com/auth/spreadsheets`\n\n*** ** * ** ***\n\n`set``Range(range)` \nSets/updates the range for this named range.\n\nParameters\n\n| Name | Type | Description |\n|---------|---------------------------------------------------|-----------------------------------------------------------|\n| `range` | [Range](/apps-script/reference/spreadsheet/range) | The spreadsheet range to associate with this named range. |\n\nReturn\n\n\n[NamedRange](#) --- the named range for which the spreadsheet range was set\n\nAuthorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/spreadsheets.currentonly`\n- `https://www.googleapis.com/auth/spreadsheets`"]]
