به اسکریپتها اجازه میدهد دادههای ساده را در جفتهای کلید-مقدار ذخیره کنند که به یک اسکریپت، یک کاربر اسکریپت یا یک سند که در آن یک افزونه استفاده میشود، محدود میشوند. ویژگیها را نمیتوان بین اسکریپتها به اشتراک گذاشت. برای اطلاعات بیشتر در مورد زمان استفاده از هر نوع ویژگی، به راهنمای سرویس ویژگیها مراجعه کنید.
// 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 | یک مخزن ویژگی (property store) دریافت میکند (فقط برای این اسکریپت) که همه کاربران میتوانند در سند، صفحه گسترده یا فرم باز به آن دسترسی داشته باشند. |
get Script Properties() | Properties | یک فروشگاه املاک دریافت میکند که همه کاربران میتوانند به آن دسترسی داشته باشند، اما فقط درون این اسکریپت. |
getUserProperties() | Properties | یک مخزن ویژگی دریافت میکند که فقط کاربر فعلی یا مؤثر میتواند به آن دسترسی داشته باشد، و فقط درون این اسکریپت. |
مستندات دقیق
get Document Properties()
یک مخزن ویژگی (property store) دریافت میکند (فقط برای این اسکریپت) که همه کاربران میتوانند در سند، صفحه گسترده یا فرم باز به آن دسترسی داشته باشند. این مخزن فقط در صورتی در دسترس است که اسکریپت به عنوان یک افزونه منتشر و اجرا شود یا اگر به یک نوع فایل گوگل متصل باشد. وقتی ویژگیهای سند در دسترس نباشند، این متد null را برمیگرداند. ویژگیهای سند ایجاد شده توسط یک اسکریپت، خارج از آن اسکریپت، حتی توسط اسکریپتهای دیگری که به همان سند دسترسی دارند، قابل دسترسی نیستند.
بازگشت
Properties - یک مخزن ویژگی فقط برای این اسکریپت که همه کاربران سند فعلی میتوانند به آن دسترسی داشته باشند، یا اگر اسکریپت افزونه نباشد یا به یک فایل Google Workspace متصل نباشد، null .
get Script Properties()
یک فروشگاه املاک دریافت میکند که همه کاربران میتوانند به آن دسترسی داشته باشند، اما فقط درون این اسکریپت.
بازگشت
Properties - یک مخزن ویژگی که همه کاربران اسکریپت میتوانند به آن دسترسی داشته باشند.
get User Properties()
یک مخزن ویژگی دریافت میکند که فقط کاربر فعلی یا مؤثر میتواند به آن دسترسی داشته باشد، و فقط درون این اسکریپت.
بازگشت
Properties - یک مخزن ویژگی که فقط کاربر فعلی یا مؤثر اسکریپت میتواند به آن دسترسی داشته باشد.