Class PropertiesService

المواقعالخدمة

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

// Sets three properties of different types.
const documentProperties = PropertiesService.getDocumentProperties();
const scriptProperties = PropertiesService.getScriptProperties();
const 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: مخزن مواقع يمكن للمستخدم الحالي للنص البرمجي فقط الوصول إليه