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