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