مقدّمة حول Google Drive Activity API

تقدّم هذه المستندات نظرة عامة على Google Drive Activity API.

تتيح لك واجهة برمجة التطبيقات Drive Activity API طلب الأحداث الأخيرة. يمكنك جلب سجلّ مفصّل لجميع الأنشطة، بما في ذلك معلومات دقيقة عن كل حدث. ويكون ذلك مفيدًا لمهام مثل عمليات التدقيق، إذ يمكنك استرداد أنشطة دقيقة تتضمّن معلومات ActionDetail وActor وTarget.

تتألف واجهة برمجة التطبيقات Drive Activity API من المورد DriveActivity الذي يمثّل التغييرات التي تم إجراؤها على العناصر داخل حساب Google Drive الخاص بأحد المستخدمين، والطريقة activity.query التي تتيح لك استرداد معلومات عن هذه التغييرات.

طلب

يطلب تطبيقك بيانات نشاط المستخدم باستخدام الطريقة activity.query. يمكنك طلب النشاط إما لعنصر معيّن في Drive أو لكل المحتوى الموجود ضمن مجلد في Drive. بالنسبة إلى طلب معيّن، يمكنك اختيار حصر الردّ باستخدام فلتر، مثل النطاق الزمني أو نوع الإجراء، ويمكنك اختيار دمج النشاط في الردّ. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تقديم الطلبات في Google Drive Activity API.

الردّ

يحتوي الردّ على قائمة بالأنشطة التي تطابق المَعلمات المُحدّدة، حيث يمثّل مورد DriveActivity كل نشاط:

شرح لرسالة نص الاستجابة لواجهة برمجة تطبيقات النشاط في Drive
الشكل 1. شرح رسالة نص الردّ في Drive Activity API

إنّ مورد DriveActivity هو مجموعة من Action عناصر، كل منها مستقل بذاته مثل حدث. يتضمّن Action كلاً من ActionDetail (مثل Create أو Edit) وActor (مثل User أو Administrator) وTarget (مثل DriveItem أو Drive) و Timestamp أو TimeRange.

يحتوي مورد DriveActivity أيضًا على معلومات موجزة، مثل كل Actor وTarget من جميع الإجراءات، وTimestamp أو TimeRange موحّد، وإما ActionDetail الأكثر أهمية أو تمثيلاً لـ Action.

لمزيد من المعلومات، يُرجى الاطّلاع على نموذج بيانات Drive Activity API.

مدى ظهور سجلّ النشاط

قد لا يتم الإبلاغ عن بعض الأنشطة على Drive عند استخدام Drive Activity API. يعتمد ما إذا كانت واجهة برمجة التطبيقات تبلّغ عن تغيير معيّن في عنصر على ما إذا كان التغيير أو المعلومات عنه مرئية للمستخدم الذي تم التحقّق من هويته في تطبيقك.

تستند إمكانية الظهور إلى الأذونات التي تم ضبطها للعنصر. في ما يلي عدة سيناريوهات تتم فيها مشاركة الملفات والمجلدات في Drive:

  • إذا شارك مؤلف مستندًا، يظهر سجلّ النشاط للمستند لكل من منشئ المستند والمستخدمين الذين تمت مشاركته معهم.

  • إذا تمت مشاركة مستند مع مستخدم ثم تم ضبطه على خاص، يمكن للمستخدم الاطّلاع على كل سجلّ النشاط من الفترة التي كان بإمكانه الوصول إليها، ولكن ليس بعد تقييد الأذونات.

  • إذا لم تتم مشاركة مستند مع مستخدم مطلقًا، لا يمكن للمستخدم الاطّلاع على أي سجلّ للنشاط.