Class DeveloperMetadata

DeveloperMetadata

الوصول إلى بيانات المطوّرين الوصفية وتعديلها لإنشاء بيانات وصفية جديدة للمطوّرين، استخدِم 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)

تنقل هذه البيانات الوصفية للمطوّر إلى العمود المحدّد. إذا كان النطاق المحدّد لا يمثّل عمودًا واحدًا، سيؤدي ذلك إلى طرح استثناء.

المعلمات

الاسمالنوعالوصف
columnRangeالنطاق الذي يمثّل العمود الذي يمثّل الموقع الجديد لهذه البيانات الوصفية الخاصة بالمطوّر.

الإرجاع

DeveloperMetadata: البيانات الوصفية للمطوّر، وذلك من أجل الربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

moveToRow(row)

تنقل هذه البيانات الوصفية للمطوّر إلى الصف المحدّد. إذا لم يمثّل النطاق المحدّد صفًا واحدًا، سيؤدي ذلك إلى حدوث خطأ.

المعلمات

الاسمالنوعالوصف
rowRangeالنطاق الذي يمثّل الصف الذي يمثّل الموقع الجديد لهذه البيانات الوصفية لمطوّر البرامج.

الإرجاع

DeveloperMetadata: البيانات الوصفية للمطوّر، وذلك من أجل الربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

moveToSheet(sheet)

تنقل هذه الدالة البيانات الوصفية للمطوّر إلى ورقة البيانات المحدّدة.

المعلمات

الاسمالنوعالوصف
sheetSheetورقة البيانات التي تمثّل الموقع الجديد لهذه البيانات الوصفية لمطوّر البرامج.

الإرجاع

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)

تضبط هذه الطريقة مفتاح البيانات الوصفية للمطوّر على القيمة المحدّدة.

المعلمات

الاسمالنوعالوصف
keyStringالمفتاح الجديد الذي سيتم ضبطه لهذه البيانات الوصفية.

الإرجاع

DeveloperMetadata: البيانات الوصفية للمطوّر، وذلك من أجل الربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setValue(value)

تضبط هذه الطريقة القيمة المرتبطة بالبيانات الوصفية للمطوّر على القيمة المحدّدة.

المعلمات

الاسمالنوعالوصف
valueStringالقيمة الجديدة التي سيتم ضبطها لهذه البيانات الوصفية.

الإرجاع

DeveloperMetadata: البيانات الوصفية للمطوّر، وذلك من أجل الربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setVisibility(visibility)

تضبط هذه السمة مستوى ظهور البيانات الوصفية للمطوّر على مستوى الظهور المحدّد.

المعلمات

الاسمالنوعالوصف
visibilityDeveloperMetadataVisibilityإذن الوصول الجديد الذي سيتم ضبطه لهذه البيانات الوصفية.

الإرجاع

DeveloperMetadata: البيانات الوصفية للمطوّر، وذلك لربطها بسلسلة.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets