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

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

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

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

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

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

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

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

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

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

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