تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class UserProperties

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الفئة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

خصائص المستخدِمين هي أزواج مفتاح/قيمة فريدة للمستخدِم. يتم تحديد نطاق "خصائص المستخدِمين" لكل مستخدِم، ويمكن لأي ملف برمجي يتم تشغيله باستخدام هوية مستخدِم الوصول إلى "خصائص المستخدِمين" لهذا المستخدِم فقط.

الطرق المتوقّفة

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`deleteAllProperties()`	`UserProperties`	يؤدي هذا الإجراء إلى حذف جميع المواقع.
`deleteProperty(key)`	`UserProperties`	تؤدي هذه الدالة إلى حذف السمة باستخدام المفتاح المحدّد.
`getKeys()`	`String[]`	الحصول على جميع المفاتيح المتاحة
`getProperties()`	`Object`	الحصول على جميع المواقع المتاحة دفعةً واحدة
`getProperty(key)`	`String`	تعرِض هذه الدالة القيمة المرتبطة بالمفتاح المقدَّم، أو القيمة الخالية إذا لم تكن هناك قيمة.
`setProperties(properties)`	`UserProperties`	تعيين مجمّع لجميع السمات المستمَدة من العنصر المحدّد
`setProperties(properties, deleteAllOthers)`	`UserProperties`	تعيين مجمّع لجميع السمات المستمَدة من العنصر المحدّد
`setProperty(key, value)`	`UserProperties`	تحافظ على القيمة المحدّدة في باستخدام المفتاح المقدَّم.

الطرق المتوقّفة

`deleteAllProperties()`

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

يؤدي هذا الإجراء إلى حذف جميع المواقع.

UserProperties.deleteAllProperties();

الإرجاع

UserProperties - هذا العنصر، لتسلسل العناصر

انظر أيضًا

deleteProperty(key)

`deleteProperty(key)`

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تؤدي هذه الدالة إلى حذف السمة باستخدام المفتاح المحدّد.

UserProperties.deleteProperty('special');

المعلمات

الاسم	النوع	الوصف
`key`	`String`	مفتاح الموقع المطلوب حذفه

الإرجاع

UserProperties - هذا العنصر، لتسلسل العناصر

انظر أيضًا

deleteAllProperties()

`getKeys()`

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

الحصول على جميع المفاتيح المتاحة

الإرجاع

String[]

`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)`

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تعرِض هذه الدالة القيمة المرتبطة بالمفتاح المقدَّم، أو القيمة الخالية إذا لم تكن هناك قيمة.

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

المعلمات

الاسم	النوع	الوصف
`key`	`String`	مفتاح القيمة المطلوب استرجاعها

الإرجاع

String: القيمة المرتبطة بالمفتاح

انظر أيضًا

setProperty(key, value)

`setProperties(properties)`

تمّ إيقاف هذا العمود نهائيًا. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.

تعيين مجمّع لجميع السمات المستمَدة من العنصر المحدّد

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

المعلمات

الاسم	النوع	الوصف
`properties`	`Object`	عنصر يحتوي على السمات المطلوب ضبطها

الإرجاع

UserProperties - هذا العنصر، لتسلسل العناصر

انظر أيضًا

setProperty(key, value)

`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 - هذا العنصر، لتسلسل العناصر

انظر أيضًا

getProperty(key)