بنية البيان

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

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

البيان

المستوى الأعلى من ضبط البيان.

تمثيل 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 المتاحة، مثل "أمريكا/دنفر".

urlFetchWhitelist[]

string

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

webapp

object (Webapp)

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