Class PropertiesService

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
PropertiesService

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

// Sets three properties of different types.
var documentProperties = PropertiesService.getDocumentProperties();
var scriptProperties = PropertiesService.getScriptProperties();
var userProperties = PropertiesService.getUserProperties();

documentProperties.setProperty('DAYS_TO_FETCH', '5');
scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/MyWeatherService/');
userProperties.setProperty('DISPLAY_UNITS', 'metric');

الطُرق

الطريقةنوع الإرجاعوصف قصير
getDocumentProperties()Propertiesتحصل على مخزن عقاري (لهذا النص البرمجي فقط) يمكن لجميع المستخدمين الوصول إليه داخل المستند المفتوح أو جدول البيانات أو النموذج.
getScriptProperties()Propertiesيحصل على متجر مواقع يمكن لجميع المستخدمين الوصول إليه، ولكن من خلال هذا النص البرمجي فقط.
getUserProperties()Propertiesتحصل على مخزن الموقع الذي يمكن للمستخدم الحالي فقط الوصول إليه، فقط ضمن هذا النص البرمجي.

المستندات التفصيلية

getDocumentProperties()

تحصل على مخزن عقاري (لهذا النص البرمجي فقط) يمكن لجميع المستخدمين الوصول إليه داخل المستند المفتوح أو جدول البيانات أو النموذج. لا يتوفّر هذا الإعداد إلا إذا تم نشر النص البرمجي وتنفيذه كإضافة أو في حال الربط مع نوع ملف من Google. عندما لا تتوفر خصائص المستند، تعرض هذه الطريقة null. لا يمكن الوصول إلى خصائص المستند التي تم إنشاؤها بواسطة نص برمجي خارج هذا النص البرمجي، حتى من خلال النصوص البرمجية الأخرى التي تصل إلى المستند نفسه.

تذكرة ذهاب وعودة

Properties - مخزن مواقع للنص البرمجي فقط، يمكن لجميع مستخدمي المستند الحالي الوصول إليه أو null إذا لم يكن النص البرمجي إضافة أو ملفًا مرتبطًا بحساب Google Workspace


getScriptProperties()

يحصل على متجر مواقع يمكن لجميع المستخدمين الوصول إليه، ولكن من خلال هذا النص البرمجي فقط.

تذكرة ذهاب وعودة

Properties - متجر خصائص يمكن لجميع مستخدمي النص البرمجي الوصول إليه


getUserProperties()

تحصل على مخزن الموقع الذي يمكن للمستخدم الحالي فقط الوصول إليه، فقط ضمن هذا النص البرمجي.

تذكرة ذهاب وعودة

Properties - متجر مواقع يمكن للمستخدم الحالي فقط للنص البرمجي الوصول إليه