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 - متجر مواقع يمكن للمستخدم الحالي للنص البرمجي فقط الوصول إليه