بنية البيان

تصف هذه الصفحة المستوى الأعلى من بنية بيانات JSON لملف بيان مشروع "برمجة تطبيقات Google".

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

البيان

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

تمثيل JSON
{
  "addOns": {
    object (AddOns)
  },
  "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.

dependencies

object (Dependencies)

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

exceptionLogging

string

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

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

object (ExecutionApi)

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

oauthScopes[]

string

تمثّل هذه السمة تعريف نطاقات التفويض التي يستخدمها مشروع النص البرمجي.

runtimeVersion

string

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

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

object (Sheets)

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

timeZone

string

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

urlFetchWhitelist[]

string

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

webapp

object (Webapp)

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