Class PropertiesService

PropertiesService

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

// 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 - مخزن مواقع إلكترونية لا يمكن إلا للمستخدم الحالي للنص البرمجي الوصول إليه