منسوخ. این کلاس منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
ویژگی های کاربر جفت های کلید-مقدار منحصر به فرد یک کاربر هستند. ویژگی های کاربر به ازای هر کاربر محدوده می شود. هر اسکریپتی که تحت هویت یک کاربر اجرا می شود می تواند فقط برای آن کاربر به ویژگی های کاربر دسترسی داشته باشد.
روش های منسوخ شده
روش | نوع برگشت | توضیح مختصر |
---|---|---|
|
| تمام خواص را حذف می کند. |
|
| ویژگی را با کلید داده شده حذف می کند. |
| String[] | تمام کلیدهای موجود را دریافت کنید. |
| Object | همه املاک موجود را یکجا دریافت کنید. |
| String | مقدار مرتبط با کلید ارائه شده را برمیگرداند یا اگر چنین مقداری وجود نداشته باشد، null را برمیگرداند. |
|
| انبوه تمام خصوصیات استخراج شده از شی داده شده را تنظیم می کند. |
|
| انبوه تمام خصوصیات استخراج شده از شی داده شده را تنظیم می کند. |
|
| مقدار مشخص شده را با کلید ارائه شده حفظ می کند. |
روش های منسوخ شده
deleteAllProperties()
deleteAllProperties()
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
تمام خواص را حذف می کند.
UserProperties.deleteAllProperties();
برگشت
- این شیء، برای زنجیر کردنUserProperties
همچنین ببینید
deleteProperty(key)
deleteProperty(key)
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
ویژگی را با کلید داده شده حذف می کند.
UserProperties.deleteProperty('special');
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
key | String | کلید برای حذف ملک |
برگشت
- این شیء، برای زنجیر کردنUserProperties
همچنین ببینید
getKeys()
getKeys()
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
تمام کلیدهای موجود را دریافت کنید.
برگشت
String[]
getProperties()
getProperties()
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
همه املاک موجود را به یکباره دریافت کنید.
این یک کپی می دهد، نه یک نمای زنده، بنابراین تغییر ویژگی ها در شیء برگشتی آنها را در ذخیره سازی به روز نمی کند و بالعکس.
UserProperties.setProperties({ "cow" : "moo", "sheep" : "baa", "chicken" : "cluck" }); // Logs "A cow goes: moo" Logger.log("A cow goes: %s", UserProperties.getProperty("cow")); // This makes a copy. Any changes that happen here will not // be written back to properties. var animalSounds = UserProperties.getProperties(); // Logs: // A chicken goes cluck! // A cow goes moo! // A sheep goes baa! for(var kind in animalSounds) { Logger.log("A %s goes %s!", kind, animalSounds[kind]); }
برگشت
Object
- یک کپی از ویژگی های حاوی جفت های کلید-مقدار
getProperty(key)
getProperty(key)
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
مقدار مرتبط با کلید ارائه شده را برمیگرداند یا اگر چنین مقداری وجود نداشته باشد، null را برمیگرداند.
var specialValue = UserProperties.getProperty('special');
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
key | String | کلید برای بازیابی مقدار |
برگشت
String
- مقدار مرتبط با کلید
همچنین ببینید
setProperties(properties)
setProperties(properties)
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
انبوه تمام خصوصیات استخراج شده از شی داده شده را تنظیم می کند.
UserProperties.setProperties({special: 'sauce', 'meaning': 42});
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
properties | Object | یک شی حاوی خصوصیات برای تنظیم. |
برگشت
- این شیء، برای زنجیر کردنUserProperties
همچنین ببینید
setProperties(properties, deleteAllOthers)
setProperties(properties, deleteAllOthers)
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
انبوه تمام خصوصیات استخراج شده از شی داده شده را تنظیم می کند.
// This deletes all other properties UserProperties.setProperties({special: 'sauce', 'meaning': 42}, true);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
properties | Object | یک شی حاوی خصوصیات برای تنظیم. |
deleteAllOthers | Boolean | آیا برای حذف تمام ویژگی های موجود. |
برگشت
- این شیء، برای زنجیر کردنUserProperties
همچنین ببینید
setProperty(key, value)
setProperty(key, value)
منسوخ. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.
مقدار مشخص شده را با کلید ارائه شده حفظ می کند. هر مقدار موجود مرتبط با این کلید بازنویسی خواهد شد.
UserProperties.setProperty('special', 'sauce');
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
key | String | کلید ملک |
value | String | ارزش مرتبط با کلید |
برگشت
- این شیء، برای زنجیر کردنUserProperties