Properties Service

خواص

این سرویس به اسکریپت‌ها اجازه می‌دهد تا رشته‌ها را به‌عنوان جفت‌های کلید-مقدار در محدوده یک اسکریپت، یک کاربر از یک اسکریپت، یا یک سند که در آن افزونه ویرایشگر استفاده می‌شود، ذخیره کنند. برای اطلاعات بیشتر در مورد زمان استفاده از هر نوع دارایی، به راهنمای سرویس Properties مراجعه کنید.

کلاس ها

نام شرح مختصر
Properties شی خواص به عنوان رابط برای دسترسی به ویژگی های کاربر، سند یا اسکریپت عمل می کند.
Properties Service به اسکریپت‌ها اجازه می‌دهد داده‌های ساده را در جفت‌های کلید-مقدار با محدوده یک اسکریپت، یک کاربر یک اسکریپت، یا یک سند که در آن یک افزونه استفاده می‌شود، ذخیره کنند.
Script Properties ویژگی های اسکریپت جفت های کلید-مقدار هستند که توسط یک اسکریپت در یک فروشگاه دائمی ذخیره می شوند.
User Properties ویژگی های کاربر جفت های کلید-مقدار منحصر به فرد یک کاربر هستند.

Properties

روش ها

روش نوع برگشت شرح مختصر
delete All Properties() Properties تمام خصوصیات موجود در فروشگاه Properties فعلی را حذف می کند.
delete Property(key) Properties ویژگی را با کلید داده شده در فروشگاه فعلی Properties حذف می کند.
get Keys() String[] همه کلیدها را در فروشگاه Properties فعلی دریافت می کند.
get Properties() Object یک کپی از تمام جفت‌های کلید-مقدار موجود در فروشگاه Properties فعلی دریافت می‌کند.
get Property(key) String مقدار مربوط به کلید داده شده را در ذخیره سازی فعلی Properties دریافت می کند، یا اگر چنین کلیدی وجود نداشته باشد null .
set Properties(properties) Properties تمام جفت‌های کلید-مقدار را از شی داده شده در ذخیره‌سازی Properties فعلی تنظیم می‌کند.
set Properties(properties, deleteAllOthers) Properties تمام جفت‌های کلید-مقدار را از شی داده‌شده در ذخیره‌سازی Properties فعلی تنظیم می‌کند و به‌صورت اختیاری همه خصوصیات دیگر را در فروشگاه حذف می‌کند.
set Property(key, value) Properties جفت کلید-مقدار داده شده را در فروشگاه Properties فعلی تنظیم می کند.

Properties Service

روش ها

روش نوع برگشت شرح مختصر
get Document Properties() Properties یک فروشگاه دارایی (فقط برای این اسکریپت) دریافت می کند که همه کاربران می توانند در سند، صفحه گسترده یا فرم باز به آن دسترسی داشته باشند.
get Script Properties() Properties یک فروشگاه دارایی دریافت می کند که همه کاربران می توانند به آن دسترسی داشته باشند، اما فقط در این اسکریپت.
get User Properties() Properties یک فروشگاه دارایی دریافت می کند که فقط کاربر فعلی می تواند به آن دسترسی داشته باشد و فقط در این اسکریپت.

Script Properties

User Properties