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