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