این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class UserProperties

منسوخ شده است. این کلاس منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

ویژگی های کاربر جفت های کلید-مقدار منحصر به فرد یک کاربر هستند. ویژگی های کاربر به ازای هر کاربر محدوده می شود. هر اسکریپتی که تحت هویت یک کاربر اجرا می شود می تواند فقط برای آن کاربر به ویژگی های کاربر دسترسی داشته باشد.

روش های منسوخ شده

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

روش های منسوخ شده

`delete All Properties()`

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

تمام خصوصیات را حذف می کند.

UserProperties.deleteAllProperties();

بازگشت

User Properties - این شی، برای زنجیر کردن

همچنین ببینید

delete Property(key)

`delete Property(key)`

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

ویژگی را با کلید داده شده حذف می کند.

UserProperties.deleteProperty('special');

پارامترها

نام	تایپ کنید	توضیحات
`key`	`String`	کلید برای حذف ملک

بازگشت

User Properties - این شی، برای زنجیر کردن

همچنین ببینید

delete All Properties()

`get Keys()`

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

تمام کلیدهای موجود را دریافت کنید.

بازگشت

String[]

`get Properties()`

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

همه املاک موجود را یکجا دریافت کنید.

این یک کپی می دهد، نه یک نمای زنده، بنابراین تغییر ویژگی ها در شیء برگشتی آنها را در ذخیره سازی به روز نمی کند و بالعکس.

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 - یک کپی از ویژگی های حاوی جفت های کلید-مقدار

`get Property(key)`

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

مقدار مرتبط با کلید ارائه شده را برمی‌گرداند یا اگر چنین مقداری وجود نداشته باشد، null را برمی‌گرداند.

const specialValue = UserProperties.getProperty('special');

پارامترها

نام	تایپ کنید	توضیحات
`key`	`String`	کلید برای بازیابی مقدار

بازگشت

String - مقدار مرتبط با کلید

همچنین ببینید

set Property(key, value)

`set Properties(properties)`

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

انبوه تمام خصوصیات استخراج شده از شی داده شده را تنظیم می کند.

UserProperties.setProperties({special: 'sauce', 'meaning': 42});

پارامترها

نام	تایپ کنید	توضیحات
`properties`	`Object`	یک شی حاوی خصوصیات برای تنظیم.

بازگشت

User Properties - این شی، برای زنجیر کردن

همچنین ببینید

set Property(key, value)

`set Properties(properties, deleteAllOthers)`

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

انبوه تمام خصوصیات استخراج شده از شی داده شده را تنظیم می کند.

// This deletes all other properties
UserProperties.setProperties({special: 'sauce', 'meaning': 42}, true);

پارامترها

نام	تایپ کنید	توضیحات
`properties`	`Object`	یک شی حاوی خصوصیات برای تنظیم.
`delete All Others`	`Boolean`	آیا برای حذف تمام ویژگی های موجود.

بازگشت

User Properties - این شی، برای زنجیر کردن

همچنین ببینید

set Property(key, value)

`set Property(key, value)`

منسوخ شده است. این تابع منسوخ شده است و نباید در اسکریپت های جدید استفاده شود.

مقدار مشخص شده را با کلید ارائه شده حفظ می کند. هر مقدار موجود مرتبط با این کلید بازنویسی خواهد شد.

UserProperties.setProperty('special', 'sauce');

پارامترها

نام	تایپ کنید	توضیحات
`key`	`String`	کلید ملک
`value`	`String`	ارزش برای ارتباط با کلید

بازگشت

User Properties - این شی، برای زنجیر کردن

همچنین ببینید

get Property(key)