بنية البيان

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

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

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