تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المواقعالخدمة
يسمح للنصوص البرمجية بتخزين بيانات بسيطة في أزواج مفتاح/قيمة على مستوى نص برمجي واحد أو مستخدم واحد لنص برمجي أو مستند واحد يتم فيه استخدام إحدى الإضافات. لا يمكن مشاركة الخصائص بين النصوص البرمجية. لمزيد من المعلومات عن حالات استخدام كل نوع من المواقع، اطّلِع على دليل خدمة المواقع.
// Sets three properties of different types.constdocumentProperties=PropertiesService.getDocumentProperties();constscriptProperties=PropertiesService.getScriptProperties();constuserProperties=PropertiesService.getUserProperties();documentProperties.setProperty('DAYS_TO_FETCH','5');scriptProperties.setProperty('SERVER_URL','http://www.example.com/MyWeatherService/',);userProperties.setProperty('DISPLAY_UNITS','metric');
تحصل على متجر خاصيات لا يمكن للمستخدم الحالي الوصول إليه إلا ضمن هذا النص البرمجي.
مستندات تفصيلية
getDocumentProperties()
تحصل على متجر موقع (لهذا النص البرمجي فقط) يمكن لجميع المستخدمين الوصول إليه ضمن الجدول المفتوح أو المستند أو النموذج. لا يتوفّر هذا الخيار إلا إذا تم نشر النص البرمجي وتنفيذه كإضافة أو إذا كان مرتبطًا بنوع ملف Google. عندما لا تكون سمات المستند متاحة، تُرجع هذه الطريقة القيمة null. لا يمكن الوصول إلى سمات المستند التي تم إنشاؤها بواسطة نص برمجي خارج هذا النص، حتى من خلال النصوص البرمجية الأخرى التي تصل إلى المستند نفسه.
الإرجاع
Properties - مخزن خاص بهذا النص البرمجي فقط يمكن لجميع مستخدمي المستند الحالي الوصول إليه، أو null إذا لم يكن النص البرمجي إضافة أو مرتبطًا بمستند Google Workspace
getScriptProperties()
تحصل على متجر مواقع يمكن لجميع المستخدمين الوصول إليه، ولكن ضمن هذا النص البرمجي فقط.
الإرجاع
Properties: متجر مواقع يمكن لجميع مستخدمي النص البرمجي الوصول إليه
getUserProperties()
تحصل على متجر خاصيات لا يمكن للمستخدم الحالي الوصول إليه إلا ضمن هذا النص البرمجي.
الإرجاع
Properties: مخزن مواقع يمكن للمستخدم الحالي للنص البرمجي فقط الوصول إليه
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Properties Service lets Apps Script store simple data as key-value pairs, with different scopes for scripts, users, and documents.\u003c/p\u003e\n"],["\u003cp\u003eIt offers three methods to access properties: \u003ccode\u003egetDocumentProperties()\u003c/code\u003e, \u003ccode\u003egetScriptProperties()\u003c/code\u003e, and \u003ccode\u003egetUserProperties()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetDocumentProperties()\u003c/code\u003e provides property storage accessible to all users within a specific document, spreadsheet, or form where the script is running.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetScriptProperties()\u003c/code\u003e allows storing properties accessible to all users, but only within the context of the current script.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetUserProperties()\u003c/code\u003e provides a property store specific to the current user and accessible only within the current script.\u003c/p\u003e\n"]]],["The `PropertiesService` stores data in key-value pairs, accessible via `getDocumentProperties`, `getScriptProperties`, and `getUserProperties`. `getDocumentProperties` stores data within a specific document, accessible to all users. `getScriptProperties` stores data within a script, accessible to all users. `getUserProperties` stores data for a single user within a script. The example code demonstrates setting properties using each method: `setProperty`. Each method returns a `Properties` object, which is a property store.\n"],null,["PropertiesService\n\nAllows scripts to store simple data in key-value pairs scoped to one script, one user of a\nscript, or one document in which an add-on is used. Properties cannot be shared between scripts.\nFor more information about when to use each type of property, see the [guide to the Properties service](/apps-script/guides/properties).\n\n```javascript\n// Sets three properties of different types.\nconst documentProperties = PropertiesService.getDocumentProperties();\nconst scriptProperties = PropertiesService.getScriptProperties();\nconst userProperties = PropertiesService.getUserProperties();\n\ndocumentProperties.setProperty('DAYS_TO_FETCH', '5');\nscriptProperties.setProperty(\n 'SERVER_URL',\n 'http://www.example.com/MyWeatherService/',\n);\nuserProperties.setProperty('DISPLAY_UNITS', 'metric');\n``` \n\nMethods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------------|------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|\n| [getDocumentProperties()](#getDocumentProperties()) | [Properties](/apps-script/reference/properties/properties) | Gets a property store (for this script only) that all users can access within the open document, spreadsheet, or form. |\n| [getScriptProperties()](#getScriptProperties()) | [Properties](/apps-script/reference/properties/properties) | Gets a property store that all users can access, but only within this script. |\n| [getUserProperties()](#getUserProperties()) | [Properties](/apps-script/reference/properties/properties) | Gets a property store that only the current user can access, and only within this script. |\n\nDetailed documentation \n\n`get``Document``Properties()` \nGets a property store (for this script only) that all users can access within the open\ndocument, spreadsheet, or form. It is only available if the script is published and executing\nas an add-on or if it is [bound](https://developers.google.com/apps-script/scripts_containers) to a Google file\ntype. When document properties are not available this method returns `null`. Document\nproperties created by a script are not accessible outside that script, even by other scripts\naccessing the same document.\n\nReturn\n\n\n[Properties](/apps-script/reference/properties/properties) --- a property store for this script only that all users of the current document can\naccess, or `null` if the script is not either an add-on or bound to a Google\nWorkspace file\n\n*** ** * ** ***\n\n`get``Script``Properties()` \nGets a property store that all users can access, but only within this script.\n\nReturn\n\n\n[Properties](/apps-script/reference/properties/properties) --- a property store that all users of the script can access\n\n*** ** * ** ***\n\n`get``User``Properties()` \nGets a property store that only the current user can access, and only within this script.\n\nReturn\n\n\n[Properties](/apps-script/reference/properties/properties) --- a property store that only the current user of the script can access"]]
