تتيح لك لوحة بيانات "برمجة تطبيقات Google" إدارة مشاريعك في "برمجة تطبيقات Google" و مراقبتها. يمكنك استخدام لوحة البيانات لتنفيذ أيٍّ مما يلي:
- عرض مشاريعك الحالية في Apps Script والبحث عنها، بما في ذلك النصوص البرمجية المرتبطة والمرفَقة بأحد Google Workspace المستندات
- إنشاء مشاريع جديدة
- يمكنك الاطّلاع على تفاصيل عن مشاريعك، مثل نطاقات OAuth التي تستخدمها.
- مراقبة حالة مشاريع النصوص البرمجية واستخدامها
- عرض سجلّات التنفيذ لمشاريعك والمشاريع الأخرى التي يتم تنفيذها باستخدام سوى سوى بيانات اعتماد حسابك
- يمكنك تفعيل واجهة برمجة التطبيقات لبرمجة التطبيقات أو إيقافها للسماح للتطبيقات باستخدام واجهة برمجة التطبيقات للتفاعل مع مشاريع النصوص البرمجية أو منعها من ذلك.
عرض المشاريع والبحث فيها
تعرض لوحة بيانات Apps Script جميع مشاريع النصوص البرمجية التي يمكنك عرضها أو تعديلها. تقسم لوحة التنقّل اليمنى في لوحة البيانات هذه المشاريع إلى الفئات التالية:
- المشاريع التي تم وضع علامة عليها المشروعات التي تراقبها
- مشاريعي: المشاريع التي تكون مالكًا لها
- كل المشاريع: المشاريع التي تمتلكها أو لديك أذونات للاطّلاع عليها أو تعديلها
- تمت مشاركتها معي: المشاريع التي لا تملكها ولكن تمت مشاركتها معك
- المهملات المشاريع التي أزلتها من Google Drive
تعرض قوائم المشاريع اسم المشروع ومالكه وتاريخ آخر تعديل. تشير رموًز بجانب اسم المشروع إلى ما إذا كان المشروع هو مشروع مستقل أو مشروع مرتبط.
عرض تفاصيل المشروع
يتضمّن كل مشروع طريقة للاطّلاع على تفاصيل المطوّر حول المشروع. لاطلاع على تفاصيل حول مشروع معيّن، انقر على الصف من قائمة المشاريع.
تعرِض طريقة عرض تفاصيل المشروع بيانات ورسومًا بيانية حول معدل الأخطاء وعمليات التنفيذ والمستخدمين في المشروع، بالإضافة إلى نطاقات OAuth المطلوبة من أي مستخدم نهائي يستخدم المشروع. يتم تعريف مقاييس البيانات على النحو التالي:
- معدّل الخطأ: النسبة المئوية للعمليات التي تعذّر تنفيذها بسبب الاستثناءات غير المسجّلة ويتم احتسابه على أنّه عمليات التنفيذ التي تعذّر إكمالها مقسومة على إجمالي عمليات التنفيذ خلال الفترة الزمنية المحدّدة.
- عمليات التنفيذ: عدد مرّات "تشغيل" مشروع أو تنفيذه. اطّلِع على أنواع التنفيذ للحصول على مزيد من المعلومات عن كيفية تنفيذ المشروع.
- المستخدمون: عدد المستخدِمين (الحسابات) الفريدين الذين نفّذوا المشروع مرّة واحدة أو أكثر خلال الفترة الزمنية المحدّدة لا يتم تتبُّع المستخدِمين المجهولين، وبالتالي لا يظهرون في عدد المستخدِمين أو الرسوم البيانية.
يظهر كلّ عملية نشر لمشروعك كعلامة تبويب في صفحة تفاصيل المشروع فوق البيانات والرسومات البيانية، ويمكنك اختيار علامة التبويب لاطلاع على البيانات المرتبطة بهذه العملية. يؤدي اختيار الكل إلى عرض dataaggregated لجميع عمليات نشر المشروع وعمليات التنفيذ الناتجة عن تشغيل المطوّرين للمشروع من داخل محرِّر رمز برمجي Apps Script.
مراقبة المشاريع
قد يكون بإمكانك الوصول إلى عدد أكبر بكثير من مشاريع Apps Script مما تستخدمه أو تُديره بشكل منتظم. لوضع إشارة على المشاريع للوصول إليها بسهولة، يمكنك وضع علامة عليها. تتيح لك إضافة مشاريع إلى المفضلة أيضًا مراقبة الإحصاءات والرسوم البيانية المُجمَّعة عن معدلات الاستخدام والأخطاء في هذه المشاريع.
لتصنيف مشروع كمشروع مميّز بنجمة، انقر على رمز المزيد > إضافة نجمة على يسار صف المشروع. يمكنك أيضًا وضع علامة على مشروع من خلال النقر على رمز المزيد أثناء عرض تفاصيل المشروع.
في شريط التنقّل الأيمن، يمكنك اختيار المشاريع التي تم وضع علامة عليها للاطّلاع على المشاريع التي bookmarked. انقر على بطاقة نسبة الأخطاء أو عمليات التنفيذ أو المستخدِمون في أعلى الصفحة للاطّلاع على الرسوم البيانية المرتبطة لجميع مشاريعك المميّزة خلال آخر 7 أيام.
يمكنك إزالة نجمة من مشروع من خلال النقر على رمز المزيد في صف المشروع واختيار إزالة النجمة.
إدارة عمليات التنفيذ
يمكنك استخدام لوحة بيانات Apps Script لعرض عمليات التنفيذ الفردية لدوالّ مشاريع Apps Script وإدارتها. يمكنك العثور على سجلّ كامل للعمليات الأخيرة من خلال اختيار العنصر عمليات التنفيذ التي أجريتها في شريط التنقّل الأيمن.
تعرض لوحة عمليات التنفيذ التي أجريتها تلقائيًا سجلّاً لجميع عمليات التنفيذ السابقة والمُشغّلة حاليًا للمشاريع التي تكون فيها مالكًا أو محرِّرًا أو مشاهدًا. يمكن أن تتضمّن هذه القائمة أيضًا عمليات تنفيذ الدوالّ في المشاريع التي لا يمكنك الوصول إليها إذا تم تنفيذها نيابةً عنك (على سبيل المثال، الإضافات التي تم تثبيتها وتنفيذها). لا تعرض قائمة التنفيذ سوى الدالة الأولية التي يتم استدعاؤها لبدء التنفيذ. ولا يعرض كل دالة تمّ استدعاؤها أثناء التنفيذ.
يمكنك التحكّم في نوع التنفيذ الذي يتم تسجيله في السجلّ باستخدام الفلاتر في أعلى طريقة العرض. يمثّل كل صف من السجلّ عملية تنفيذ واحدة. تعرِض أعمدة وقت البدء والمدة والحالة المعلومات المقابلة عن عملية التنفيذ هذه.
يعرض عمود الدالة اسم الدالة التي بدأت تنفيذ الإجراء. لا يظهر أي اسم في هذا العمود إذا لم يكن لديك إذن بالوصول إلى مشروع النص البرمجي المقابل للتنفيذ ولكن تم تشغيله نيابةً عنك.
يعرض عمود النوع ما بدأ التنفيذ. وتتضمّن القيم ما يلي:
- إضافة. نشأ التنفيذ من إضافة.
- Execution API: نشأ التنفيذ من طلب واجهة برمجة التطبيقات Apps Script API.
- الاستناد إلى الوقت: حدث التنفيذ بسبب حدث زمني.
- العامل المشغِّل: نشأ التنفيذ من مصدر مشغّل.
- تطبيق الويب: نشأ التنفيذ من تطبيق ويب تم نشره.
- المحرِّر: نشأ التنفيذ من محرِّر "برمجة تطبيقات Google".
إنهاء عمليات التنفيذ
يتمّ الإشارة إلى عمليات التنفيذ التي تستغرق وقتًا طويلاً والتي لا تزال قيد التقدّم حاليًا من خلال الحالة "جارٍ التنفيذ". لإيقاف عمليات التنفيذ هذه، انقر على رمز المزيد > إنهاء على يسار صف المشروع.
الإعدادات
يمكنك تعديل إعدادات لوحة البيانات من خلال اختيار الإعدادات في عمود التنقّل الأيمن.
في لوحة الإعدادات، يتوفّر زر تبديل لواجهة برمجة التطبيقات "برمجة تطبيقات Google". يتيح لك ذلك منح واجهة برمجة التطبيقات إذن الوصول إلى مشاريع النصوص البرمجية.
للوصول إلى هذا الخيار، انقر على تصنيف Google Apps Script API في لوحة الإعدادات. يؤدي ذلك إلى فتح لوحة جديدة تتضمّن نص تحذير و مفتاح تبديل. يتم إيقاف إمكانية الوصول إلى مشاريع النصوص البرمجية تلقائيًا كإجراء وقائي للحفاظ على الأمان. بعد منح إذن الوصول، يمكن لأي تطبيق تابع لجهة خارجية منح الإذن له باستخدام واجهة برمجة التطبيقات لتعديل النصوص البرمجية وعمليات النشر. ويمكنك في أي وقت سحب إذن الوصول هذا من لوحة الإعدادات.
يمكنك العثور على مزيد من المعلومات في دليل الوصول إلى Apps Script API.