Class ScriptProperties

ویژگی‌های اسکریپت

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

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

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

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

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

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 را برمی‌گرداند.

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

پارامترها

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

بازگشت

String|null — مقدار مرتبط با کلید

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

• setProperty(key, value)

---

setProperties(properties)

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

Bulk-sets تمام ویژگی‌های استخراج‌شده از شیء داده‌شده را تنظیم می‌کند.

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

پارامترها

نام	نوع	توضیحات
properties	Object	یک شیء حاوی ویژگی‌هایی که باید تنظیم شوند.

بازگشت

ScriptProperties — این شیء، برای زنجیره‌سازی

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

• setProperty(key, value)

---

setProperties(properties, deleteAllOthers)

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

Bulk-sets تمام ویژگی‌های استخراج‌شده از شیء داده‌شده را تنظیم می‌کند.

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

پارامترها

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

بازگشت

ScriptProperties — این شیء، برای زنجیره‌سازی

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

• setProperty(key, value)

---

setProperty(key, value)

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

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

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

پارامترها

نام	نوع	توضیحات
key	String	کلید برای ملک
value	String	مقداری که قرار است به کلید مرتبط شود

بازگشت

ScriptProperties — این شیء، برای زنجیره‌سازی

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

• getProperty(key)