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

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