تتألف واجهة برمجة التطبيقات 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 API.
إذن الوصول إلى سجلّ النشاط
قد لا يتم تسجيل بعض الأنشطة على Drive عند استخدام واجهة برمجة التطبيقات هذه. تعتمد إمكانية تسجيل واجهة برمجة التطبيقات Drive Activity API لتغيير معيّن في عنصر على ما إذا كان التغيير أو معلومات عن التغيير مرئية للمستخدم المُعتمَد في تطبيقك.
تستند مستوى الوصول إلى الأذونات التي تم ضبطها للعنصر. هناك عدة سيناريوهات عند مشاركة الملفات والمجلدات في Drive:
- إذا شارك مؤلف مستندًا، لن يكون سجلّ نشاطه مرئيًا لصانع المحتوى فقط، بل للمستخدمين الذين تم مصادقة هويتهم الذين تمت مشاركته معهم أيضًا.
- إذا تمت مشاركة مستند مع مستخدم ثم تم جعله خاصًا، يمكن للمستخدم الذي تم مصادقة هويته الاطّلاع على سجلّ الأنشطة بالكامل عندما كان لديه إذن الوصول إلى المستند وأنّ الأذونات أصبحت الآن محدودة.
- إذا لم تتم مشاركة مستند مع مستخدم مطلقًا، لن يتمكّن هذا المستخدم من الاطّلاع على أي سجلّ نشاط.
البدء
للاستفادة إلى أقصى حدّ من Drive Activity API، عليك دمج تطبيقك مع Google Drive API أولاً. للبدء باستخدام Drive Activity API، تعرَّف على كيفية إنشاء مشروع و منح الإذن بالطلبات. أو يمكنك الاطّلاع على مزيد من المعلومات عن الأنشطة في مرجع واجهة برمجة التطبيقات.