Class PropertiesService

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