لوحة بيانات "برمجة تطبيقات Google"

تتيح لك لوحة بيانات "برمجة التطبيقات" إدارة مشاريع "برمجة التطبيقات" ومراقبتها. يمكنك استخدام لوحة المعلومات للقيام بأي مما يلي:

  • عرض مشاريع "برمجة التطبيقات" الحالية والبحث عنها، بما في ذلك النصوص البرمجية المرتبطة المرفقة مع Google Workspace المستندات
  • أنشِئ مشاريع جديدة.
  • عرض تفاصيل عن مشاريعك، مثل نطاقات OAuth التي يستخدمها.
  • راقِب سلامة مشاريع النصوص البرمجية واستخدامها.
  • يمكنك عرض سجلات التنفيذ لمشاريعك وغيرها من المشاريع التي تعمل باستخدام بيانات اعتماد حسابك.
  • فعِّل واجهة برمجة التطبيقات لبرمجة التطبيقات أو أوقِفها للسماح للتطبيقات باستخدام واجهة برمجة التطبيقات أو منعها من التفاعل مع مشاريع النصوص البرمجية.

عرض المشاريع والبحث عنها

تسرد لوحة بيانات "برمجة التطبيقات" جميع مشاريع النصوص البرمجية التي يمكنك عرضها أو تعديلها. يقسم التنقل الأيسر من لوحة المعلومات هذه المشروعات إلى الفئات التالية:

  • المشاريع المميّزة بنجمة. المشاريع التي monitoring.
  • مشاريعي. المشاريع التي تملك أنت مالكها
  • جميع المشاريع: المشاريع التي تمتلكها أو لديك أذونات العرض أو التعديل لها.
  • تمت مشاركتها معي المشروعات التي لا تملكها ولكن تمت مشاركتها معك.
  • المهملات المشاريع التي أزلتها من Google Drive.

تعرض قوائم المشروع اسم المشروع ومالكه وتاريخ آخر تعديل. تشير الرموز الموجودة بجانب اسم المشروع إلى ما إذا كان المشروع مشروعًا مستقل أو مشروعًا مرتبطًا.

عرض تفاصيل المشروع

ويتضمن كل مشروع طريقة عرض للاطلاع على تفاصيل المطور حول المشروع. لعرض تفاصيل حول مشروع ما، انقر فوق الصف من قائمة المشروعات.

تعرض طريقة عرض تفاصيل المشروع بيانات معدل الخطأ وعمليات التنفيذ والمستخدمين ورسومات بيانية عن المشروع، بالإضافة إلى نطاقات OAuth المطلوبة لأي مستخدم نهائي يستخدم المشروع. يتم تعريف مقاييس البيانات على النحو التالي:

  • معدل الأخطاء: النسبة المئوية لعمليات التنفيذ التي تعذّر تنفيذها بسبب استثناءات غير مرصودة. ويتم احتسابه عن طريق قسمة عمليات التنفيذ الفاشلة على إجمالي عمليات التنفيذ خلال الفترة الزمنية المحددة.
  • عمليات التنفيذ: عدد المرات التي تم فيها "تشغيل" المشروع أو تنفيذه. راجع أنواع التنفيذ للحصول على مزيد من المعلومات حول كيفية تشغيل المشروع.
  • المستخدمون: عدد المستخدمين الفريدين (الحسابات) الذين شغّلوا المشروع مرة واحدة أو أكثر خلال الفترة الزمنية المحددة. لا يتم تتبع المستخدمين المجهولين وبالتالي لا ينعكس ذلك في عدد المستخدمين أو الرسوم البيانية.

تظهر كل عملية نشر لمشروعك كعلامة تبويب في صفحة تفاصيل المشروع أعلى البيانات والرسومات البيانية؛ ويمكنك اختيار علامة التبويب لعرض البيانات المرتبطة بعملية النشر هذه. يؤدي اختيار الكل إلى عرض بيانات مجمّعة لجميع عمليات نشر المشروع ومن عمليات التنفيذ الناتجة عن تشغيل المطورين للمشروع من داخل أداة تعديل الرموز لبرمجة التطبيقات.

مراقبة المشاريع

قد يكون بإمكانك الوصول إلى مشاريع "برمجة تطبيقات Google" بعدد أكبر بكثير من مشاريع "برمجة التطبيقات" التي تستخدمها أو تديرها بانتظام. لوضع إشارة على المشاريع للوصول إليها بسهولة، يمكنك تمييزها بنجمة. يتيح لك تمييز المشروعات بنجمة أيضًا مراقبة الإحصاءات المجمّعة للاستخدام ومعدل الخطأ والرسوم البيانية حول تلك المشروعات.

لتمييز مشروع بنجمة، انقر على رمز المزيد > إضافة نجمة على يسار صف المشروع. يمكنك أيضًا تمييز مشروع بنجمة من خلال النقر على رمز المزيد أثناء عرض تفاصيل المشروع.

في شريط التنقّل الأيمن، يمكنك اختيار المشاريع المميّزة بنجمة للاطّلاع على المشاريع التي وضعت إشارة عليها. انقر على بطاقة قياس الأداء معدل الخطأ أو عمليات التنفيذ أو المستخدمون في أعلى الصفحة لعرض الرسوم البيانية ذات الصلة لجميع المشاريع المميزة بنجمة خلال آخر 7 أيام.

يمكنك إزالة نجمة من مشروع عن طريق النقر على رمز المزيد في صف المشروع واختيار إزالة النجمة.

إدارة عمليات التنفيذ

يمكنك استخدام لوحة بيانات "برمجة تطبيقات Google" لعرض عمليات التنفيذ الفردية لوظائف مشروع "برمجة تطبيقات Google" وإدارتها. يمكنك العثور على سجل كامل بعمليات التنفيذ الأخيرة عن طريق تحديد العنصر عمليات التنفيذ الخاصة بي في شريط التنقل الأيمن.

تعرض لوحة عمليات التنفيذ بشكل تلقائي سجلاً بجميع عمليات التنفيذ السابقة وقيد التشغيل حاليًا للمشروعات التي تملكين فيها دور مالك أو محرِّر أو مُشاهد. ويمكن أن تتضمّن هذه القائمة أيضًا عمليات تنفيذ الدوال في المشاريع التي لا يمكنك الوصول إليها إذا كانت تعمل نيابةً عنك (على سبيل المثال، الإضافات التي ثبَّتها وشغلتها). لا تعرض قائمة التنفيذ سوى الدالة الأولية التي يتم استدعاؤها لبدء التنفيذ. فهي لا تعرض كل دالة تم استدعاءها أثناء عملية التنفيذ هذه.

يمكنك التحكّم في نوع التنفيذ الذي يتم الإبلاغ عنه في السجلّ باستخدام الفلاتر في أعلى الملف الشخصي. يمثل كل صف من السجل عملية تنفيذ واحدة. تعرض أعمدة وقت البدء والمدة والحالة المعلومات المتجاوبة حول عملية التنفيذ هذه.

يعرِض عمود الدالة اسم الدالة التي بدأت عملية التنفيذ. لا يوجد اسم في هذا العمود إذا لم يكن لديك حق الوصول إلى مشروع النص البرمجي المقابل للتنفيذ ولكن تم تشغيله نيابةً عنك.

يعرض عمود النوع العنصر الذي بدأ التنفيذ. وتتضمّن القيم ما يلي:

  • إضافة. نشأت عملية التنفيذ من إضافة.
  • واجهة برمجة تطبيقات التنفيذ: نشأت عملية التنفيذ من استدعاء واجهة برمجة التطبيقات لبرمجة التطبيقات.
  • الوقت المستغرق. تسبب التنفيذ في حدث زمني.
  • عامل التفعيل: نشأت عملية التنفيذ من مصدر مشغّل.
  • Webapp: نشأت عملية التنفيذ من تطبيق ويب تم نشره.
  • محرِّر: نشأت عملية التنفيذ من محرِّر "برمجة تطبيقات Google".

إنهاء عمليات التنفيذ

تتم الإشارة إلى عمليات التنفيذ الطويلة المدى التي تكون قيد التقدم حاليًا من خلال الحالة "قيد التشغيل". لإيقاف عمليات التنفيذ هذه، على يسار صف المشروع، انقر على رمز المزيد > إنهاء.

الإعدادات

يمكنك ضبط إعدادات لوحة التحكم عن طريق تحديد الإعدادات في شريط التنقل الأيمن.

في لوحة الإعدادات، يتوفر زر إيقاف/تفعيل واجهة برمجة التطبيقات لبرمجة التطبيقات. يتيح لك ذلك منح واجهة برمجة التطبيقات إذن الوصول إلى مشاريع النصوص البرمجية.

للوصول إلى زر التبديل هذا، انقر على التصنيف واجهة برمجة التطبيقات لبرمجة تطبيقات Google في لوحة الإعدادات. يؤدي ذلك إلى فتح لوحة جديدة بها نص تحذير ومفتاح تبديل. يكون الوصول إلى مشاريع النصوص البرمجية غير مفعّل تلقائيًا كإجراء وقائي أمني. بعد منح الإذن بالوصول، يمكن لأي تطبيق تابع لجهة خارجية منح إذن استخدام واجهة برمجة التطبيقات لتعديل النصوص البرمجية وعمليات النشر. ويمكنك إبطال هذا الوصول في أي وقت من خلال لوحة الإعدادات.

يمكنك العثور على مزيد من المعلومات في دليل الوصول إلى واجهة برمجة التطبيقات لبرمجة التطبيقات.