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

Class ScriptProperties

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

ویژگی های اسکریپت جفت های کلید-مقدار هستند که توسط یک اسکریپت در یک فروشگاه دائمی ذخیره می شوند. ویژگی‌های اسکریپت بر اساس اسکریپت مشخص می‌شوند، صرف نظر از اینکه کدام کاربر اسکریپت را اجرا می‌کند.

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

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

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

`deleteAllProperties()`

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

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

ScriptProperties.deleteAllProperties();

بازگشت

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

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

deleteProperty(key)

`deleteProperty(key)`

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

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

ScriptProperties.deleteProperty('special');

پارامترها

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

بازگشت

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

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

deleteAllProperties()

`getKeys()`

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

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

بازگشت

String[]

`getProperties()`

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

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

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

ScriptProperties.setProperties({
  "cow"     : "moo",
  "sheep"   : "baa",
  "chicken" : "cluck"
});

// Logs "A cow goes: moo"
Logger.log("A cow goes: %s", ScriptProperties.getProperty("cow"));

// This makes a copy. Any changes that happen here will not
// be written back to properties.
var animalSounds = ScriptProperties.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)`

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

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

var specialValue = ScriptProperties.getProperty('special');

پارامترها

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

بازگشت

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

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

setProperty(key, value)

`setProperties(properties)`

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

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

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

پارامترها

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

بازگشت

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

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

setProperty(key, value)

`setProperties(properties, deleteAllOthers)`

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

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

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

پارامترها

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

بازگشت

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

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

setProperty(key, value)

`setProperty(key, value)`

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

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

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

پارامترها

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

بازگشت

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

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

getProperty(key)