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