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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

وتتم الإشارة إلى عمليات التنفيذ الطويلة الأمد الجارية حاليًا باستخدام الحالة " "Run". لإيقاف عمليات التنفيذ هذه، على يسار صف المشروع، انقر على "المزيد" &gt؛ وإنهاء.

الإعدادات

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

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

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

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

الدعم

إذا كنت تواجه خطأً أو كنت بحاجة إلى مساعدة بشأن استخدام لوحة بيانات "برمجة تطبيقات Google"، عليك البدء بالبحث عن Stack Overflow أو النشر فيها:

طرح سؤال جديد

Bugs

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

إذا كانت المشكلة جديدة تمامًا، يمكنك أيضًا الإبلاغ عنها في أداة تتبّع المشاكل. إذا حدث ذلك، يُرجى التأكد من تضمين المعلومات التالية في وصف الخطأ:

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

يُرجى الانتباه إلى أن المشاكل قد تكون هادئة نسبيًا لفترة من الوقت. وهذا لا يعني أننا لن نحلّ أبدًا أي مشكلة، بل أنّه ما من تحديثات حاليًا.

الإبلاغ عن خطأ جديد

مميزات مفقودة

إذا كانت هناك ميزة أو وظيفة غير متوفرة في لوحة البيانات وأردت استخدامها، يمكنك البحث في أداة تتبّع المشاكل لتحديد ما إذا كان الآخرون قد طلبوها. إذا كان قد تم طلبها من قبل، يُرجى وضع إشارة نجمة على المشكلة (انقر على النجمة بجانب رقم المشكلة)—ونعطي الأولوية للأخطاء التي تتلقى المزيد من النجوم. يمكنك أيضًا إضافة تعليقات إلى المشاكل الحالية، ولكن يجب تنفيذ هذه الخطوة فقط في حال إضافة سياق أو معلومات إضافية حول المشكلة.

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

طلب ميزة جديدة