بنية البيان

توضّح هذه الصفحة المستوى الأعلى لبنية بيانات JSON الخاصة بملف البيان في مشروع Apps Script. يحدّد البيان وظيفة مشروع 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 الجديدة، ننصحك باستخدام الحقل addOns.chat بدلاً من ذلك. إذا كنت تحتفظ بتطبيق Chat حالي يستخدم الحقل chat، يجب أن يكون عنصرًا فارغًا.

لضبط تفاصيل تطبيق Chat، عليك تفعيل واجهة برمجة تطبيقات Google Chat. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة ضبط واجهة برمجة تطبيقات Google Chat.

تتعامل "برمجة تطبيقات 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)

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