نظرة عامة على واجهة برمجة التطبيقات لإعداد التقارير

واجهة برمجة التطبيقات لإعداد التقارير عبارة عن واجهة برمجة تطبيقات مريحة يمكنك استخدامها للوصول إلى معلومات حول أنشطة مستخدمي Google Workspace. واجهة برمجة التطبيقات لإعداد التقارير هي جزء من واجهة برمجة تطبيقات SDK للمشرف.

توفر واجهة برمجة التطبيقات لإعداد التقارير نوعين من التقارير:

  • تقارير النشاط، التي تُبلغ عن الأحداث لتطبيق أو خدمة معينة، مثل Google Drive أو وحدة تحكم المشرف.
  • تقارير الاستخدام، التي تسرد أحداث مساحة العمل التي تسبب فيها المستخدمون.
    • تسرد تقارير استخدام العميل الأحداث لجميع المستخدمين في نطاقك.
    • تسرد تقارير استخدام المستخدم الأحداث التي ينظمها المستخدم.

في ما يلي قائمة بالعبارات الشائعة المستخدمة في واجهة برمجة التطبيقات لإعداد التقارير:

تقارير النشاط

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

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

توفِّر تقارير الاستخدام معلومات عن أحداث Google Workspace في نطاقك. ويمكنك استخدام واجهة برمجة التطبيقات لطلب معلومات محددة عن المستخدمين.

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

الخطوات التالية

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

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

  • يعرض لك قسم التفويض كيفية استخدام رموز الدخول عبر OAuth 2.0 للحصول على بيانات المستخدم من تطبيقات وخدمات Google Workspace.

  • للعثور على تفاصيل حول نوع مورد أو طريقة محددة، راجع مرجع واجهة برمجة التطبيقات.

  • لمزيد من المعلومات، يُرجى الاطّلاع على أداة تتبُّع مشاكل واجهة برمجة تطبيقات SDK للمشرف ومدونة مطوّري برامج Google Workspace ومركز مساعدة مشرف Google Workspace.