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