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)

المستخدم الذي عدّل الملف مؤخرًا. لا يظهر حقل القراءة فقط هذا إلا للمستخدمين الذين لديهم إذن WRITER لمشروع النص البرمجي.

createTime

string (Timestamp format)

الطابع الزمني لتاريخ الإنشاء لا يظهر حقل القراءة فقط هذا إلا للمستخدمين الذين لديهم إذن WRITER لمشروع النص البرمجي.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

الطابع الزمني لتاريخ آخر تعديل لا يظهر حقل القراءة فقط هذا إلا للمستخدمين الذين لديهم إذن WRITER لمشروع النص البرمجي.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

تمثّل هذه السمة القائمة المرتبة لأسماء مَعلمات الدالة في مشروع البرنامج النصي.