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