Properties Service

خواص

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

کلاس ها

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

Properties

مواد و روش ها

روش نوع برگشت توضیح مختصر
deleteAllProperties() Properties تمام خصوصیات موجود در فروشگاه Properties فعلی را حذف می کند.
deleteProperty(key) Properties ویژگی را با کلید داده شده در فروشگاه فعلی Properties حذف می کند.
getKeys() String[] همه کلیدها را در فروشگاه Properties فعلی دریافت می کند.
getProperties() Object یک کپی از تمام جفت‌های کلید-مقدار موجود در فروشگاه Properties فعلی دریافت می‌کند.
getProperty(key) String مقدار مربوط به کلید داده شده را در ذخیره سازی فعلی Properties دریافت می کند، یا اگر چنین کلیدی وجود نداشته باشد، null .
setProperties(properties) Properties تمام جفت‌های کلید-مقدار را از شی داده شده در ذخیره‌سازی Properties فعلی تنظیم می‌کند.
setProperties(properties, deleteAllOthers) Properties تمام جفت‌های کلید-مقدار را از شی داده‌شده در ذخیره‌سازی Properties فعلی تنظیم می‌کند و به‌صورت اختیاری همه خصوصیات دیگر را در فروشگاه حذف می‌کند.
setProperty(key, value) Properties جفت کلید-مقدار داده شده را در فروشگاه Properties فعلی تنظیم می کند.

PropertiesService

مواد و روش ها

روش نوع برگشت توضیح مختصر
getDocumentProperties() Properties یک فروشگاه دارایی (فقط برای این اسکریپت) دریافت می کند که همه کاربران می توانند در سند، صفحه گسترده یا فرم باز به آن دسترسی داشته باشند.
getScriptProperties() Properties یک فروشگاه دارایی دریافت می کند که همه کاربران می توانند به آن دسترسی داشته باشند، اما فقط در این اسکریپت.
getUserProperties() Properties یک فروشگاه دارایی دریافت می کند که فقط کاربر فعلی می تواند به آن دسترسی داشته باشد و فقط در این اسکریپت.

ScriptProperties

UserProperties