بنية البيان

توضّح هذه الصفحة المستوى الأعلى لبنية بيانات 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" مع التفويض على مستوى النص البرمجي. لا يمكن لتطبيقات المحادثة التي تتطلّب تفويضًا تنفيذ أي إجراءات إلى أن يفوّض المستخدم تطبيق المحادثة. لنشر رسالة قبل التفويض، يمكنك إضافة عنصر 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)

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