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