نظرة عامة على Reports API

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

توفِّر Reports API نوعَين من التقارير:

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

في ما يلي قائمة بالعبارات الشائعة المستخدَمة في Reports API:

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

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

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

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

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

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