الوصول إلى البيانات الوصفية للمطوّر وتعديلها لإنشاء بيانات وصفية جديدة لمطوّر البرامج، استخدِم Range.addDeveloperMetadata(key)
أو Sheet.addDeveloperMetadata(key)
أو Spreadsheet.addDeveloperMetadata(key)
.
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
get | Integer | تعرِض هذه الدالة المعرّف الفريد المرتبط بهذه البيانات الوصفية للمطوّر. |
get | String | تعرِض هذه السمة المفتاح المرتبط بهذه البيانات الوصفية للمطوّر. |
get | Developer | تعرِض هذه السمة موقع البيانات الوصفية لمطوّر البرامج. |
get | String | لعرض القيمة المرتبطة بهذه البيانات الوصفية للمطوّر، أو null إذا لم تكن لهذه البيانات الوصفية قيمة. |
get | Developer | لعرض مستوى ظهور هذه البيانات الوصفية لمطوّر البرامج. |
move | Developer | تنقل هذه البيانات الوصفية للمطوّر إلى العمود المحدّد. |
move | Developer | نقل هذه البيانات الوصفية للمطوّر إلى الصف المحدّد |
move | Developer | تنقل هذه البيانات الوصفية لمطوّر البرامج إلى ورقة البيانات المحدّدة. |
move | Developer | نقل هذه البيانات الوصفية لمطوّر البرامج إلى جدول البيانات من المستوى الأعلى |
remove() | void | يؤدي إلى حذف هذه البيانات الوصفية. |
set | Developer | لضبط مفتاح هذه البيانات الوصفية لمطوّر البرامج على القيمة المحدّدة |
set | Developer | ضبط القيمة المرتبطة بهذه البيانات الوصفية للمطوّر على القيمة المحدّدة |
set | Developer | لضبط مستوى ظهور هذه البيانات الوصفية للمطوّر على مستوى الظهور المحدّد |
مستندات تفصيلية
getId()
تعرِض هذه الدالة المعرّف الفريد المرتبط بهذه البيانات الوصفية للمطوّر.
الإرجاع
Integer
: المعرّف الفريد المرتبط بهذه البيانات الوصفية للمطوّر
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getKey()
تعرِض هذه السمة المفتاح المرتبط بهذه البيانات الوصفية للمطوّر.
الإرجاع
String
: المفتاح المرتبط بهذه البيانات الوصفية للمطوّر
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLocation()
تعرِض هذه السمة موقع البيانات الوصفية لمطوّر البرامج.
الإرجاع
Developer
: موقع البيانات الوصفية لمطوّر البرامج هذا.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValue()
لعرض القيمة المرتبطة بهذه البيانات الوصفية للمطوّر، أو null
إذا لم تكن لهذه البيانات الوصفية قيمة.
الإرجاع
String
: القيمة المرتبطة بهذه البيانات الوصفية لمطوّر البرامج، أو null
إذا لم يكن لهذه البيانات الوصفية
أي قيمة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVisibility()
لعرض مستوى ظهور هذه البيانات الوصفية لمطوّر البرامج.
الإرجاع
Developer
: مستوى ظهور هذه البيانات الوصفية للمطوّر
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveToColumn(column)
تنقل هذه البيانات الوصفية للمطوّر إلى العمود المحدّد. إذا لم يكن النطاق المحدّد يمثّل عمودًا واحدًا، سيؤدي ذلك إلى طرح استثناء.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
column | Range | النطاق الذي يمثّل العمود الذي يشكّل الموقع الجديد لبيانات المطوّر الوصفية هذه. |
الإرجاع
Developer
: البيانات الوصفية للمطوّر، لربط العناصر ببعضها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveToRow(row)
نقل هذه البيانات الوصفية للمطوّر إلى الصف المحدّد إذا لم يمثّل النطاق المحدّد صفًا واحدًا، سيؤدي ذلك إلى طرح استثناء.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
row | Range | النطاق الذي يمثّل الصفّ الذي يمثّل الموقع الجديد لهذه البيانات الوصفية لمطوّر البرامج. |
الإرجاع
Developer
: البيانات الوصفية للمطوّر، لربط العناصر ببعضها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveToSheet(sheet)
تنقل هذه البيانات الوصفية لمطوّر البرامج إلى ورقة البيانات المحدّدة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
sheet | Sheet | ورقة البيانات التي تم نقل البيانات الوصفية لمطوّر البرامج إليها |
الإرجاع
Developer
: البيانات الوصفية للمطوّر، لربط العناصر ببعضها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveToSpreadsheet()
نقل هذه البيانات الوصفية لمطوّر البرامج إلى جدول البيانات من المستوى الأعلى
الإرجاع
Developer
: البيانات الوصفية للمطوّر، لربط العناصر ببعضها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
يؤدي إلى حذف هذه البيانات الوصفية.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setKey(key)
لضبط مفتاح هذه البيانات الوصفية لمطوّر البرامج على القيمة المحدّدة
المعلمات
الاسم | النوع | الوصف |
---|---|---|
key | String | المفتاح الجديد الذي يجب ضبطه لهذه البيانات الوصفية. |
الإرجاع
Developer
: البيانات الوصفية للمطوّر، لربط العناصر ببعضها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValue(value)
ضبط القيمة المرتبطة بهذه البيانات الوصفية للمطوّر على القيمة المحدّدة
المعلمات
الاسم | النوع | الوصف |
---|---|---|
value | String | القيمة الجديدة التي سيتم ضبطها لهذه البيانات الوصفية. |
الإرجاع
Developer
: البيانات الوصفية للمطوّر، لربط العناصر ببعضها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVisibility(visibility)
لضبط مستوى ظهور هذه البيانات الوصفية للمطوّر على مستوى الظهور المحدّد
المعلمات
الاسم | النوع | الوصف |
---|---|---|
visibility | Developer | إذن الوصول الجديد المطلوب ضبطه لهذه البيانات الوصفية |
الإرجاع
Developer
: البيانات الوصفية للمطوّر، لربط العناصر ببعضها
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets