File
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ملف فردي ضمن مشروع نص برمجي الملف هو رمز مصدر تابع لجهة خارجية أنشأه مطوّر واحد أو أكثر. يمكن أن يكون رمز JS من جهة الخادم أو HTML أو ملف إعداد. يمكن أن يحتوي كل مشروع نص برمجي على ملفات متعددة.
تمثيل JSON |
{
"name": string,
"type": enum (FileType ),
"source": string,
"lastModifyUser": {
object (User )
},
"createTime": string,
"updateTime": string,
"functionSet": {
object (FunctionSet )
}
} |
الحقول |
name |
string
تمثّل هذه السمة اسم الملف. امتداد الملف ليس جزءًا من اسم الملف، ويمكن تحديده من حقل النوع.
|
type |
enum (FileType )
تمثّل هذه السمة نوع الملف.
|
source |
string
محتوى الملف
|
lastModifyUser |
object (User )
المستخدم الذي عدّل الملف مؤخرًا. يتم التحكّم في التفاصيل المرئية في هذا العنصر من خلال إعدادات إذن الوصول إلى الملف الشخصي للمستخدم الذي أجرى آخر تعديل.
|
createTime |
string (Timestamp format)
الطابع الزمني لتاريخ الإنشاء يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقّة تصل إلى نانوثانية مع ما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z" .
|
updateTime |
string (Timestamp format)
الطابع الزمني لتاريخ آخر تعديل يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقّة تصل إلى نانوثانية مع ما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z" .
|
functionSet |
object (FunctionSet )
مجموعة الدوال المحدّدة في ملف البرنامج النصي، إن وُجدت
|
FileType
تعداد لأنواع الملفات المختلفة
عمليات التعداد |
ENUM_TYPE_UNSPECIFIED |
نوع الملف غير محدّد، ولم يتم استخدامه مطلقًا. |
SERVER_JS |
ملف رمز من جهة الخادم في "برمجة تطبيقات Google" |
HTML |
ملف يحتوي على HTML من جهة العميل |
JSON |
ملف بتنسيق JSON يُستخدَم هذا النوع فقط لبيان مشروع النص البرمجي. يجب أن يتطابق محتوى ملف البيان مع بنية ScriptManifest صالح. |
FunctionSet
مجموعة من الدوال ولا يُسمح بالتكرار.
تمثيل JSON |
{
"values": [
{
object (Function )
}
]
} |
الحقول |
values[] |
object (Function )
قائمة بالدوال التي تتألف منها المجموعة
|
الوظيفة
تمثّل هذه السمة دالة في مشروع نص برمجي.
تمثيل JSON |
{
"name": string,
"parameters": [
string
]
} |
الحقول |
name |
string
اسم الدالة في مشروع البرنامج النصي.
|
parameters[] |
string
القائمة المرتبة لأسماء مَعلمات الدالة في مشروع البرنامج النصي
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-17 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-17 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eA file in a script project represents third-party source code and can be server-side JS, HTML, or a configuration file.\u003c/p\u003e\n"],["\u003cp\u003eEach script project can contain multiple files, each with properties like name, type, source code, and modification details.\u003c/p\u003e\n"],["\u003cp\u003eFiles can contain a set of functions, each defined by its name and parameters, contributing to the script's functionality.\u003c/p\u003e\n"],["\u003cp\u003eFiles can be of various types, including server-side JavaScript, HTML, JSON for the project manifest, ensuring diverse script capabilities.\u003c/p\u003e\n"]]],[],null,["# File\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [FileType](#FileType)\n- [FunctionSet](#FunctionSet)\n - [JSON representation](#FunctionSet.SCHEMA_REPRESENTATION)\n- [Function](#Function)\n - [JSON representation](#Function.SCHEMA_REPRESENTATION)\n\nAn individual file within a script project. A file is a third-party source code created by one or more developers. It can be a server-side JS code, HTML, or a configuration file. Each script project can contain multiple files.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"type\": enum (/apps-script/api/reference/rest/v1/File#FileType), \"source\": string, \"lastModifyUser\": { object (/apps-script/api/reference/rest/v1/projects#User) }, \"createTime\": string, \"updateTime\": string, \"functionSet\": { object (/apps-script/api/reference/rest/v1/File#FunctionSet) } } ``` |\n\n| Fields ||\n|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The name of the file. The file extension is not part of the file name, which can be identified from the type field. |\n| `type` | `enum (`[FileType](/apps-script/api/reference/rest/v1/File#FileType)`)` The type of the file. |\n| `source` | `string` The file content. |\n| `lastModifyUser` | `object (`[User](/apps-script/api/reference/rest/v1/projects#User)`)` The user who modified the file most recently. The details visible in this object are controlled by the profile visibility settings of the last modifying user. |\n| `createTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Creation date timestamp. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `updateTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Last modified date timestamp. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `functionSet` | `object (`[FunctionSet](/apps-script/api/reference/rest/v1/File#FunctionSet)`)` The defined set of functions in the script file, if any. |\n\nFileType\n--------\n\nAn enumeration of different types of files.\n\n| Enums ||\n|-------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `ENUM_TYPE_UNSPECIFIED` | Undetermined file type; never actually used. |\n| `SERVER_JS` | An Apps Script server-side code file. |\n| `HTML` | A file containing client-side HTML. |\n| `JSON` | A file in JSON format. This type is only used for the script project's manifest. The manifest file content must match the structure of a valid [ScriptManifest](/apps-script/concepts/manifests) |\n\nFunctionSet\n-----------\n\nA set of functions. No duplicates are permitted.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------|\n| ``` { \"values\": [ { object (/apps-script/api/reference/rest/v1/File#Function) } ] } ``` |\n\n| Fields ||\n|------------|------------------------------------------------------------------------------------------------------------------|\n| `values[]` | `object (`[Function](/apps-script/api/reference/rest/v1/File#Function)`)` A list of functions composing the set. |\n\nFunction\n--------\n\nRepresents a function in a script project.\n\n| JSON representation |\n|------------------------------------------------------|\n| ``` { \"name\": string, \"parameters\": [ string ] } ``` |\n\n| Fields ||\n|----------------|-------------------------------------------------------------------------------------|\n| `name` | `string` The function name in the script project. |\n| `parameters[]` | `string` The ordered list of parameter names of the function in the script project. |"]]