تسمح هذه الميزة للنصوص البرمجية بتخزين البيانات البسيطة في أزواج المفتاح/القيمة على نطاق واحد من نص برمجي أو مستخدم واحد من نص برمجي أو مستند واحد يتم فيه استخدام إضافة. لا يمكن مشاركة المواقع بين النصوص البرمجية. لمزيد من المعلومات عن حالات استخدام كل نوع من المواقع، اطّلِع على دليل خدمة المواقع.
// 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
- متجر مواقع يمكن للمستخدم الحالي فقط للنص البرمجي الوصول إليه