بنية البيان

توضِّح هذه الصفحة المستوى الأعلى من ملف بيان مشروع Apps Script بتنسيق JSON. يحدِّد البيان وظيفة مشروع Apps Script أو الغرض منه.

تمثيل JSON
{
  "addOns": {
    object (AddOns)
  },
  "chat": {},
  "dependencies": {
    object (Dependencies)
  },
  "exceptionLogging": string,
  "executionApi": {
    object (ExecutionApi)
  },
  "oauthScopes": [
    string
  ],
  "runtimeVersion": string,
  "sheets": {
    object (Sheets)
  },
  "timeZone": string,
  "urlFetchWhitelist": [
    string
  ],
  "webapp": {
    object (Webapp)
  }
}
الحقول
addOns

object (AddOns)

إعدادات الموارد للمشروع في حال نشره كأحد الإضافات في Google Workspace

chat

object

إعدادات المشروع في حال نشره كأحد تطبيقات Google Chat. لضبط تفاصيل تطبيق Chat، عليك تفعيل Google Chat API. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة ضبط Google Chat API.

تعالج "برمجة تطبيقات Google" عملية التفويض على مستوى النص البرمجي. لا يمكن لتطبيقات Chat التي تتطلّب تفويضًا تنفيذ أي إجراءات إلى أن يفوض المستخدم تطبيق Chat. لنشر رسالة قبل التفويض، يمكنك إضافة عنصر addToSpaceFallbackMessage إلى البيان. إذا كان تطبيق Chat يتطلّب منطقًا لبدء التشغيل، قد تحتاج إلى تكرار هذا المنطق في الإجراء onMessage.

يعرض المثال التالي تطبيق Chat الذي يستجيب برسالة ترحيب تلقائية عندما يضيفه مستخدم إلى مساحة Chat:

        "chat": {
          "addToSpaceFallbackMessage": "Thank you for adding me!"
        }
        

dependencies

object (Dependencies)

إعدادات الخدمات المتقدّمة والمكتبات التي تم تفعيلها لاستخدامها من قِبل مشروع النصوص البرمجية

exceptionLogging

string

الموقع الجغرافي الذي يتم تسجيل الاستثناءات فيه في ما يلي الإعدادات الصالحة:

  • يشير الرمز NONE إلى أنّه لم يتم تسجيل الاستثناءات.
  • يشير الرمز STACKDRIVER إلى أنّه يتم تسجيل الاستثناءات في Stackdriver.
executionApi

object (ExecutionApi)

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

oauthScopes[]

string

تعريف نطاقات التفويض المستخدَمة في مشروع النصوص البرمجية

runtimeVersion

string

إصدار وقت التشغيل الذي يستخدمه النص البرمجي إذا لم يكن هذا الحقل متوفّرًا في البيان، يستخدم النص البرمجي وقت التشغيل التلقائي (STABLE). في ما يلي الخيارات الصالحة لهذا الحقل:

  • يشير الرمز STABLE إلى وقت التشغيل التلقائي (Rhino حاليًا).
  • يشير الرمز V8 إلى وقت التشغيل المستنِد إلى V8.
  • يشير الرمز DEPRECATED_ES5 إلى وقت تشغيل Rhino. يؤدي ضبط هذه القيمة أيضًا إلى منع نقل البيانات التلقائي إلى الإصدار 8.
sheets

object (Sheets)

إعدادات المورد التي تحدِّد وحدات الماكرو في "جداول بيانات Google"

timeZone

string

المنطقة الزمنية للنص البرمجي في إحدى قيم ZoneId المتاحة، مثل "America/Denver"

urlFetchWhitelist[]

string

قائمة بادئات عناوين URL التي تستخدم HTTPS يجب أن تتطابق أيّ نقطة نهاية لعنوان URL يتم جلبها مع إحدى البادئات الواردة في هذه القائمة، في حال توفّرها. ويمكن أن يساعد ذلك في حماية بيانات المستخدمين. هذا الحقل اختياري لعمليات النشر التجريبية، ولكنه مطلوب لعمليات النشر. مزيد من المعلومات حول إدراج عناوين URL في القائمة المسموح بها

webapp

object (Webapp)

إعدادات تطبيق الويب لمشروع النصوص البرمجية، والتي لا يتم استخدامها إلا إذا تم نشر المشروع كتطبيق ويب.