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

‫Reports API هي واجهة برمجة تطبيقات RESTful يمكنك استخدامها للوصول إلى معلومات عن أنشطة المستخدمين على Google Workspace. تشكّل هذه الواجهة جزءًا من 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، يُرجى الاطّلاع على دليل تلقّي الإشعارات الفورية.

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