إنشاء النطاقات المُعنونة في جدول بيانات والوصول إليها وتعديلها النطاقات المُعنونة هي نطاقات لها أسماء مستعارة لسلسلة مرتبطة. ويمكن الاطّلاع عليها وتعديلها من خلال واجهة مستخدم "جداول بيانات Google" ضمن قائمة البيانات > النطاقات المُعنوَنة....
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
getName() | String | الحصول على اسم هذا النطاق المُعنون |
getRange() | Range | للحصول على النطاق الذي يشير إليه هذا النطاق المُعنوَن. |
remove() | void | لحذف هذا النطاق المُعنون. |
setName(name) | NamedRange | يضبط/يحدِّث اسم النطاق المسمى. |
setRange(range) | NamedRange | لضبط/تحديث النطاق لهذا النطاق المسمى. |
الوثائق التفصيلية
getName()
الحصول على اسم هذا النطاق المُعنون
استرجاع الكرة
String
— اسم هذا النطاق المُعنون
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange()
للحصول على النطاق الذي يشير إليه هذا النطاق المُعنوَن.
استرجاع الكرة
Range
— نطاق جدول البيانات المرتبط بهذا النطاق المُعنوَن
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
لحذف هذا النطاق المُعنون.
// The code below deletes all the named ranges in the spreadsheet. var namedRanges = SpreadsheetApp.getActive().getNamedRanges(); for (var i = 0; i < namedRanges.length; i++) { namedRanges[i].remove(); }
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
يضبط/يحدِّث اسم النطاق المسمى.
// The code below updates the name for the first named range. var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); if (namedRanges.length > 1) { namedRanges[0].setName("UpdatedNamedRange"); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
name | String | الاسم الجديد للنطاق المُعنون. |
استرجاع الكرة
NamedRange
— النطاق الذي تم ضبط اسمه في المكالمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRange(range)
لضبط/تحديث النطاق لهذا النطاق المسمى.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
range | Range | نطاق جدول البيانات المطلوب ربطه بهذا النطاق المُعنون. |
استرجاع الكرة
NamedRange
- النطاق المُعنون الذي تم ضبط نطاق جدول البيانات له
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets