توضِّح هذه الصفحة المستوى الأعلى من ملف بيان مشروع Apps Script بتنسيق JSON.
يتم تحديد البنى الفرعية لملف البيان في صفحات منفصلة:
Manifest
addOns
: ضبط إعدادات إضافة Google Workspacechat
: ضبط إعدادات تطبيق Google Chatdependencies
: التبعيات ل مكتبات "برمجة تطبيقات Google" والخدمات المتقدّمةSheets
: إعدادات وحدة ماكرو واحدة أو أكثر من "جداول بيانات Google"ExecutionApi
Webapp
: إعدادات تطبيق ويب
البيان
المستوى الأعلى لإعدادات البيان
تمثيل 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 |
إعدادات الموارد للمشروع في حال نشره كأحد الإضافات في Google Workspace |
chat |
إعدادات المشروع في حال نشره كأحد تطبيقات Google Chat. لضبط تفاصيل تطبيق Chat، عليك تفعيل Google Chat API. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة ضبط Google Chat API.
تعالج "برمجة تطبيقات Google" عملية التفويض على مستوى النص البرمجي.
لا يمكن لتطبيقات Chat التي تتطلّب تفويضًا تنفيذ
أي إجراءات إلى أن يفوض المستخدم تطبيق Chat.
لنشر رسالة قبل التفويض، يمكنك إضافة عنصر
يعرض المثال التالي تطبيق Chat الذي يستجيب برسالة ترحيب تلقائية عندما يضيفه مستخدم إلى مساحة Chat: "chat": { "addToSpaceFallbackMessage": "Thank you for adding me!" } |
dependencies |
إعدادات الخدمات المتقدّمة والمكتبات التي تم تفعيلها لاستخدامها من قِبل مشروع النصوص البرمجية |
exceptionLogging |
الموقع الجغرافي الذي يتم تسجيل الاستثناءات فيه في ما يلي الإعدادات الصالحة:
|
executionApi |
إعدادات ملف التشغيل لواجهة برمجة التطبيقات في المشروع النصي ولا يتم استخدام هذا الإجراء إلا في حال نشر المشروع لتنفيذ واجهة برمجة التطبيقات. |
oauthScopes[] |
تعريف نطاقات التفويض المستخدَمة في مشروع النصوص البرمجية |
runtimeVersion |
إصدار وقت التشغيل الذي يستخدمه
النص البرمجي إذا لم يكن هذا الحقل متوفّرًا في البيان، يستخدم النص البرمجي
وقت التشغيل التلقائي (
|
sheets |
إعدادات المورد التي تحدِّد وحدات الماكرو في "جداول بيانات Google" |
timeZone |
المنطقة الزمنية للنص البرمجي في إحدى قيم ZoneId المتاحة، مثل "America/Denver" |
urlFetchWhitelist[] |
قائمة بادئات عناوين URL التي تستخدم HTTPS يجب أن تتطابق أيّ نقطة نهاية لعنوان URL يتم جلبها مع إحدى البادئات الواردة في هذه القائمة، في حال توفّرها. ويمكن أن يساعد ذلك في حماية بيانات المستخدمين. هذا الحقل اختياري لعمليات النشر التجريبية، ولكنه مطلوب لعمليات النشر. مزيد من المعلومات حول إدراج عناوين URL في القائمة المسموح بها |
webapp |
إعدادات تطبيق الويب لمشروع النصوص البرمجية، والتي لا يتم استخدامها إلا إذا تم نشر المشروع كتطبيق ويب. |