تمّت إزالة هذا العمود. تم إيقاف هذه الفئة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
خصائص المستخدمين هي أزواج من المفاتيح والقيم فريدة للمستخدم. وتكون خصائص المستخدِمين على مستوى كلّ مستخدِم. أي يمكن للنص البرمجي الذي يعمل باستخدام هوية المستخدم الوصول إلى خصائص المستخدمين لهذا المستخدم فقط.
طرق متوقّفة نهائيًا
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
|
| تحذف جميع المواقع. |
|
| تحذف السمة باستخدام المفتاح المحدّد. |
| String[] | الحصول على جميع المفاتيح المتاحة |
| Object | احصل على جميع المواقع المتاحة في آنٍ واحد. |
| String | تعرض القيمة المرتبطة بالمفتاح الذي تم تقديمه أو قيمة خالية إذا لم يكن هناك مثل هذه القيمة. |
|
| تعمل هذه السياسة على ضبط جميع الخصائص المأخوذة من الكائن المحدّد بشكل مجمّع. |
|
| تعمل هذه السياسة على ضبط جميع الخصائص المأخوذة من الكائن المحدّد بشكل مجمّع. |
|
| للمحافظة على القيمة المحددة باستخدام المفتاح المتوفر. |
طرق متوقّفة نهائيًا
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)
تمّت إزالة هذا العمود. تم إيقاف هذه الدالة نهائيًا ويجب عدم استخدامها في النصوص البرمجية الجديدة.
تعرض القيمة المرتبطة بالمفتاح الذي تم تقديمه أو قيمة خالية إذا لم يكن هناك مثل هذه القيمة.
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