به ابرداده توسعهدهنده دسترسی داشته باشید و آن را تغییر دهید. برای ایجاد ابرداده برنامهنویس جدید از 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)
این ابرداده توسعه دهنده را به ستون مشخص شده منتقل می کند. اگر محدوده مشخص شده یک ستون واحد را نشان ندهد، یک استثنا ایجاد می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
column | Range | محدوده نشان دهنده ستونی است که مکان جدید این ابرداده توسعه دهنده است. |
برگشت
DeveloperMetadata
- ابرداده توسعه دهنده، برای زنجیره سازی.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveToRow(row)
این ابرداده توسعه دهنده را به ردیف مشخص شده منتقل می کند. اگر محدوده مشخص شده یک ردیف را نشان ندهد، یک استثنا ایجاد می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
row | Range | محدوده ای که نشان دهنده ردیفی است که مکان جدید این ابرداده توسعه دهنده است. |
برگشت
DeveloperMetadata
- ابرداده توسعه دهنده، برای زنجیره سازی.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveToSheet(sheet)
این ابرداده توسعه دهنده را به برگه مشخص شده منتقل می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
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)
کلید این ابرداده توسعه دهنده را روی مقدار مشخص شده تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
key | String | کلید جدیدی که برای این ابرداده تنظیم می شود. |
برگشت
DeveloperMetadata
- ابرداده توسعه دهنده، برای زنجیره سازی.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValue(value)
مقدار مرتبط با این ابرداده توسعه دهنده را روی مقدار مشخص شده تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
value | String | مقدار جدیدی که برای این فراداده تنظیم می شود. |
برگشت
DeveloperMetadata
- ابرداده توسعه دهنده، برای زنجیره سازی.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVisibility(visibility)
نمایان بودن این ابرداده برنامهنویس را روی نمایان بودن مشخص شده تنظیم میکند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
visibility | DeveloperMetadataVisibility | نمای جدید برای تنظیم این ابرداده. |
برگشت
DeveloperMetadata
- ابرداده توسعه دهنده، برای زنجیره سازی.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets