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