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