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