به اسکریپت‌ها اجازه می‌دهد داده‌های ساده را در جفت‌های کلید-مقدار با محدوده یک اسکریپت، یک کاربر یک اسکریپت، یا یک سند که در آن یک افزونه استفاده می‌شود، ذخیره کنند. ویژگی ها را نمی توان بین اسکریپت ها به اشتراک گذاشت. برای اطلاعات بیشتر در مورد زمان استفاده از هر نوع دارایی، به راهنمای سرویس Properties مراجعه کنید.
// Sets three properties of different types.
const documentProperties = PropertiesService.getDocumentProperties();
const scriptProperties = PropertiesService.getScriptProperties();
const userProperties = PropertiesService.getUserProperties();
documentProperties.setProperty('DAYS_TO_FETCH', '5');
scriptProperties.setProperty(
'SERVER_URL',
'http://www.example.com/MyWeatherService/',
);
userProperties.setProperty('DISPLAY_UNITS', 'metric');روش ها
| روش | نوع برگشت | شرح مختصر |
|---|---|---|
get Document Properties() | Properties | یک فروشگاه دارایی (فقط برای این اسکریپت) دریافت می کند که همه کاربران می توانند در سند، صفحه گسترده یا فرم باز به آن دسترسی داشته باشند. |
get Script Properties() | Properties | یک فروشگاه دارایی دریافت می کند که همه کاربران می توانند به آن دسترسی داشته باشند، اما فقط در این اسکریپت. |
get User Properties() | Properties | یک فروشگاه دارایی دریافت می کند که فقط کاربر فعلی می تواند به آن دسترسی داشته باشد و فقط در این اسکریپت. |
مستندات دقیق
get Document Properties()
یک فروشگاه دارایی (فقط برای این اسکریپت) دریافت می کند که همه کاربران می توانند در سند، صفحه گسترده یا فرم باز به آن دسترسی داشته باشند. این تنها در صورتی در دسترس است که اسکریپت به عنوان یک افزونه منتشر و اجرا شود یا اگر به یک نوع فایل Google محدود شده باشد. هنگامی که ویژگی های سند در دسترس نباشد، این روش null را برمی گرداند. ویژگی های سند ایجاد شده توسط یک اسکریپت خارج از آن اسکریپت قابل دسترسی نیست، حتی توسط اسکریپت های دیگری که به همان سند دسترسی دارند.
بازگشت
Properties - یک فروشگاه دارایی برای این اسکریپت فقط که همه کاربران سند فعلی می‌توانند به آن دسترسی داشته باشند، یا اگر اسکریپت افزونه نباشد یا به یک فایل Google Workspace متصل نشده باشد، null
get Script Properties()
یک فروشگاه دارایی دریافت می کند که همه کاربران می توانند به آن دسترسی داشته باشند، اما فقط در این اسکریپت.
بازگشت
Properties - یک فروشگاه دارایی که همه کاربران اسکریپت می توانند به آن دسترسی داشته باشند
get User Properties()
یک فروشگاه دارایی دریافت می کند که فقط کاربر فعلی می تواند به آن دسترسی داشته باشد و فقط در این اسکریپت.
بازگشت
Properties - یک فروشگاه دارایی که فقط کاربر فعلی اسکریپت می تواند به آن دسترسی داشته باشد