تتألف Google Drive Activity API من مورد DriveActivity الذي يمثل التغييرات التي يتم إجراؤها على العناصر في Google Drive للمستخدم، وطريقة activity.query التي تتيح لك استرداد معلومات عن تلك التغييرات.
الطلب
يطلب تطبيقك بيانات نشاط المستخدم باستخدام طريقة activity.query. يمكنك طلب النشاط إما لعنصر محدد في Drive أو لكل العناصر الموجودة في مجلد Drive. في طلب معيّن، يمكنك اختيار حصر الاستجابة بالقيود، مثل النطاق الزمني أو نوع الإجراء، ويمكنك اختيار دمج النشاط في الردّ. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تقديم طلبات في Drive Activity API.
الإجابة
يكون الردّ على الطلب قائمة بالأنشطة التي تطابق المَعلمات المحدَّدة،
حيث يمثّل مورد
DriveActivity كل نشاط:
مورد DriveActivity هو مجموعة من عناصر
Action، وكل عنصر
مستقل مثل حدث. يشمل Action
ActionDetail (مثل Create
أو Edit) وActor (مثل User
أو Administrator) وTarget (مثل DriveItem أو Drive) وإما
Timestamp
أو TimeRange.
يحتوي مورد DriveActivity أيضًا على معلومات موجزة، مثل كل
Actor و
Target من جميع الإجراءات، بالإضافة إلى مورد
Timestamp
أو TimeRange، وإما الأكثر
أهمية أو تمثيلاًActionDetail
من بين
Action.
لمزيد من المعلومات، يمكنك الاطّلاع على نموذج بيانات واجهة برمجة تطبيقات Drive Activity.
إذن الوصول إلى سجلّ النشاط
وقد لا يتم الإبلاغ عن بعض الأنشطة على Drive عند استخدام واجهة برمجة التطبيقات هذه. سواء كانت Drive Activity API تُبلغ عن تغيير معيَّن في عنصر ما بناءً على ما إذا كان التغيير أو المعلومات المتعلقة بالتغيير ستظهر للمستخدم الذي تمت مصادقته في تطبيقك أم لا.
يستند مستوى الرؤية إلى الأذونات التي تم تعيينها للكائن. هناك العديد من السيناريوهات عند مشاركة الملفات والمجلدات في Drive:
- إذا شارك المؤلف مستندًا، يكون سجلّ الأنشطة للمستند مرئيًا ليس فقط لصانع المحتوى، بل أيضًا للمستخدمين الذين تمت مشاركة المستند معهم.
- في حال مشاركة مستند مع مستخدم ثم جعله خاصًا، يمكن للمستخدم الذي تمت مصادقته الاطّلاع على سجلّ الأنشطة بالكامل أثناء منحه إذن الوصول، وبذلك تكون الأذونات محدودة.
- إذا لم تتم مشاركة مستند مع مستخدم مطلقًا، لن يتمكن المستخدم من الاطّلاع على أي سجلّ أنشطة.
البدء
للاستفادة إلى أقصى حد من Drive Activity API، ادمج تطبيقك أولاً مع Google Drive API. لبدء استخدام Drive Activity API، تعرَّف على كيفية إنشاء مشروع وتفويض الطلبات. أو يمكنك التعمق وقراءة الأنشطة في مرجع واجهة برمجة التطبيقات.