يسمح هذا النطاق للبرامج النصية بتخزين بيانات بسيطة في أزواج المفتاح/القيمة ضمن نطاق برنامج نصي واحد أو مستخدم واحد لبرنامج نصي أو مستند واحد يتم فيه استخدام إضافة. لا يمكن مشاركة الخصائص بين النصوص البرمجية. لمزيد من المعلومات حول الحالات التي يجب فيها استخدام كل نوع من المواقع، اطّلِع على دليل خدمة المواقع.
// 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');
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
get | Properties | يحصل على مساحة تخزين للسمات (لهذا النص البرمجي فقط) يمكن لجميع المستخدمين الوصول إليها ضمن المستند أو جدول البيانات أو النموذج المفتوح. |
get | Properties | تعرض هذه الدالة مخزنًا للسمات يمكن لجميع المستخدمين الوصول إليه، ولكن فقط ضمن هذا النص البرمجي. |
getUserProperties() | Properties | يحصل على مخزن للسمات لا يمكن الوصول إليه إلا من خلال المستخدم الحالي أو الفعلي، وضمن هذا النص البرمجي فقط. |
مستندات تفصيلية
get Document Properties()
يحصل على مساحة تخزين للسمات (لهذا النص البرمجي فقط) يمكن لجميع المستخدمين الوصول إليها ضمن المستند أو جدول البيانات أو النموذج المفتوح. لا يتوفّر هذا الوضع إلا إذا تم نشر النص البرمجي وتنفيذه كإضافة أو إذا كان مرتبطًا بنوع ملف Google. عندما لا تكون خصائص المستند متاحة، تعرض هذه الطريقة null. لا يمكن الوصول إلى سمات المستند التي تم إنشاؤها بواسطة نص برمجي خارج هذا النص، حتى من خلال نصوص برمجية أخرى تصل إلى المستند نفسه.
الإرجاع
Properties: متجر خصائص لهذا النص البرمجي فقط يمكن لجميع مستخدمي المستند الحالي الوصول إليه، أو null إذا لم يكن النص البرمجي إضافة أو مرتبطًا بملف Google Workspace.
get Script Properties()
تعرض هذه الدالة مخزنًا للسمات يمكن لجميع المستخدمين الوصول إليه، ولكن فقط ضمن هذا النص البرمجي.
الإرجاع
Properties: متجر مواقع يمكن لجميع مستخدمي النص البرمجي الوصول إليه.
get User Properties()
يحصل على مخزن للسمات لا يمكن الوصول إليه إلا من خلال المستخدم الحالي أو الفعلي، وضمن هذا النص البرمجي فقط.
الإرجاع
Properties: هو مخزن للسمات لا يمكن الوصول إليه إلا من خلال المستخدم الحالي أو الفعلي للنص البرمجي.