بنية البيان

توضّح هذه الصفحة المستوى الأعلى لبنية بيانات JSON الخاصة بملف بيان برمجة تطبيقات Google. يحدّد ملف البيان وظيفة مشروع "برمجة تطبيقات 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، يجب تفعيل واجهة برمجة تطبيقات Google Chat. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة ضبط واجهة برمجة تطبيقات Google Chat.

تتعامل "برمجة تطبيقات Google" مع التفويض على مستوى النص البرمجي. لا يمكن لتطبيق محادثات يتطلّب تفويضًا تنفيذ إجراءات إلى أن يمنحه المستخدم التفويض. لنشر رسالة قبل الحصول على التفويض، أضِف عنصر addToSpaceFallbackMessage إلى ملف البيان. إذا كان تطبيق محادثات يتطلّب منطق تهيئة، قد تحتاج إلى تكرار هذا المنطق في إجراء onMessage.

يعرض المثال التالي تطبيق محادثات يردّ برسالة ترحيب تلقائية عندما يضيفه مستخدم إلى مساحة 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)

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