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)

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

المَعلمات

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

استرجاع الكرة

DeveloperMetadata — البيانات الوصفية لمطوِّر البرامج للتسلسل.

التفويض

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

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

moveToRow(row)

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

المَعلمات

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

استرجاع الكرة

DeveloperMetadata — البيانات الوصفية لمطوِّر البرامج للتسلسل.

التفويض

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

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

moveToSheet(sheet)

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

المَعلمات

الاسمTypeالوصف
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)

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

المَعلمات

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

استرجاع الكرة

DeveloperMetadata — البيانات الوصفية لمطوِّر البرامج للتسلسل.

التفويض

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

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

setValue(value)

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

المَعلمات

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

استرجاع الكرة

DeveloperMetadata — البيانات الوصفية لمطوِّر البرامج للتسلسل.

التفويض

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

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

setVisibility(visibility)

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

المَعلمات

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

استرجاع الكرة

DeveloperMetadata — البيانات الوصفية لمطوِّر البرامج للتسلسل.

التفويض

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

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