بنية البيان

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

يتم تحديد البُنى الأساسية للبيان في صفحات منفصلة:

البيان

المستوى الأعلى لإعدادات البيان

تمثيل 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)

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