واجهة برمجة التطبيقات لإعداد التقارير هي واجهة برمجة تطبيقات 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 في نطاقك. يمكنك استخدام واجهة برمجة التطبيقات لطلب معلومات محدّدة عن المستخدمين.
- تقارير استخدام العملاء: تهدف إلى عرض أنشطة تفصيلية للتطبيقات والخدمات في حسابك. يتم تنظيم معلومات الاستخدام حسب نوع التطبيق، وتحتوي على معلومات خاصة بهذا التطبيق.
- تقارير استخدام المستخدمين: تعرِض هذه التقارير الأنشطة التي أجراها مستخدمو حسابك. ويمكن تخصيص هذه التقارير وfiltrare للحصول على معلومات استخدام معيّنة. يتم تنظيم معلومات الاستخدام هذه حسب نوع التطبيق، وتحتوي على معلومات خاصة بهذا التطبيق.
- تقارير استخدام الكيانات: تهدف إلى سرد الأنشطة ذات الصلة بالكيانات التي يستخدمها مستخدمو حسابك في تطبيق Currents.
- الإشعارات
- توفّر Reports API إشعارات تتيح لك مراقبة الأحداث، مثل التغييرات في الموارد. عندما تراقِب مرجعًا ويتغيّر هذا المرجع، تُرسِل واجهة برمجة التطبيقات Reports API إشعارًا إليك. لمزيد من المعلومات عن إعداد الإشعارات وتلقّيها من Reports API، اطّلِع على دليل تلقّي الإشعارات الفورية.
الخطوات التالية
للتعرّف على Reports API ومعرفة كيفية عملها، استخدِم دليل "التشغيل السريع"، الذي يتم إدراجه حسب لغة البرمجة في شريط التنقّل الأيمن. يمكنك أيضًا المتابعة في هذا القسم للاطّلاع على معلومات عامة عن إعداد حسابك.
يوضّح لك قسم التفويض كيفية استخدام الرموز المميزة للوصول في OAuth 2.0 للحصول على بيانات المستخدمين من تطبيقات Google Workspace وخدماتها.
للعثور على تفاصيل نوع مورد أو طريقة معيّنة، يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات.
لمزيد من المعلومات، يُرجى الاطّلاع على تتبُّع المشاكل في Admin SDK API، ومدوّنة مطوّري Google Workspace، ومركز مساعدة مشرف Google Workspace.