Class 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