Reporting API هي واجهة برمجة تطبيقات RESTful يمكنك استخدامها للوصول إلى معلومات عن أنشطة Google Workspace للمستخدمين تُعد واجهة برمجة التطبيقات لإعداد التقارير جزءًا من واجهة برمجة تطبيقات SDK للمشرف.
توفّر واجهة برمجة التطبيقات لإعداد التقارير نوعَين من التقارير:
- تقارير النشاط، التي تُبلغ عن أحداث تطبيق معيّن أو خدمة مثل Google Drive أو وحدة تحكُّم المشرف.
- تقارير الاستخدام التي تسرد أحداث مساحة العمل الناتجة عن المستخدمين
- تسرد تقارير استخدام العملاء الأحداث لجميع المستخدمين في نطاقك.
- تعرِض تقارير استخدام المستخدم الأحداث المنظّمة حسب المستخدم.
في ما يلي قائمة بالمصطلحات الشائعة المستخدمة في واجهة برمجة التطبيقات لإعداد التقارير:
- تقارير الأنشطة
تسرد تقارير النشاط معلومات عن الأنشطة في نطاق Google Workspace محدّد التطبيق أو الخدمة. تتضمن تقارير النشاط التاريخ والوقت والمستخدم والنوع من النشاط. تشير رسالة الأشكال البيانية مرجع واجهة برمجة التطبيقات يحتوي على قائمة كاملة بتقارير النشاط والمعلومات التي تتضمنها. في ما يلي بعض الأمثلة عن تقارير النشاط المُدرَجة حسب التطبيق أو الخدمة:
- تقارير نشاط المشرف عرض الأنشطة التي أجراها المشرفون باستخدام وحدة تحكُّم المشرف. على سبيل المثال: يمكنك الحصول على قائمة بجميع المرات التي غيّر فيها المشرفون اسم المستخدم باستخدام وحدة تحكُّم المشرف.
- تقارير النشاط على Google Drive إدراج كيفية تعديل المستخدمين في نطاقك لمستندات Drive وعرضها. بالنسبة يمكنك مثلاً الحصول على قائمة بنشاط مستخدم معيّن على Drive.
- تقارير نشاط تسجيل الدخول تقديم معلومات بشأن وقت تسجيل دخول مستخدمي حسابك وخروجهم من الحسابات. يمكنك، على سبيل المثال، الحصول على تقرير بجميع عمليات تسجيل الدخول إلى مجال خلال فترة زمنية محددة.
- تقارير نشاط الجوّال عرض الأنشطة باستخدام أجهزة جوّال تديرها إدارة Google للأجهزة الجوّالة. على سبيل المثال، يمكنك تلقّي إشعار عندما يسجِّل المستخدمون جهازًا جديدًا.
- تقارير نشاط رمز OAuth المميّز إدراج الأحداث عندما يقدّم المستخدمون الرموز المميزة للتفويض أو أبطلوها من خلال مواقع إلكترونية وتطبيقات تابعة لجهات خارجية يمكنك استخدام واجهة برمجة التطبيقات لإعداد التقارير قائمة بجميع أذونات وصول الجهات الخارجية إلى بيانات المستخدم على Google Workspace.
- تقارير الاستخدام
توفّر تقارير الاستخدام معلومات عن أحداث Google Workspace في نطاقك. يمكنك استخدام واجهة برمجة التطبيقات لطلب معلومات محدّدة عن المستخدمين.
- تقارير استخدام العملاء إدراج أنشطة التطبيقات والخدمات التفصيلية في حسابك. هذا الاستخدام يتم تنظيم المعلومات حسب نوع التطبيق وتحتوي على معلومات الخاصة بهذا التطبيق.
- تقارير استخدام المستخدمين عرض الأنشطة حسب مستخدمي حسابك يمكن تخصيص هذه التقارير وتصفيتها للحصول على معلومات استخدام محددة. يتم تنظيم معلومات الاستخدام هذه حسب نوع التطبيق ويحتوي على معلومات خاصة بهذا التطبيق.
- تقارير استخدام الكيانات إدراج الأنشطة المرتبطة بالكيانات التي يستخدمها مستخدمو حسابك في تطبيق Currents.
- الإشعارات
- توفّر واجهة برمجة التطبيقات لإعداد التقارير إشعارات تتيح لك مراقبة الأحداث، مثل. التغييرات على الموارد. عندما تشاهد موردًا ويتغير هذا المورد، سترسل إليك واجهة برمجة التطبيقات لإعداد التقارير إشعارًا. لمزيد من المعلومات حول إعداد تلقّي الإشعارات من واجهة برمجة التطبيقات لإعداد التقارير، اطّلِع على دليل تلقّي الإشعارات الفورية:
الخطوات التالية
للتعرف على واجهة برمجة التطبيقات لإعداد التقارير والتأكد من عملها، استخدم التشغيل السريع، والتي يتم إدراجها حسب لغة البرمجة على شريط التنقل الأيسر. يمكنك يمكنك أيضًا المتابعة من خلال هذا القسم لقراءة المعلومات العامة حول إعداد لحسابك.
تشير رسالة الأشكال البيانية التفويض كيفية استخدام رموز الدخول عبر OAuth 2.0 للحصول على بيانات المستخدمين من تطبيقات Google Workspace وخدماتها
للعثور على تفاصيل نوع أو طريقة معيّنة من الموارد، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات.
لمزيد من المعلومات، يُرجى الاطّلاع على أداة تتبُّع مشاكل واجهة برمجة التطبيقات Admin SDK API الـ مدوّنة مطوّري Google Workspace، و مركز مساعدة مشرف Google Workspace