تتألف واجهة برمجة التطبيقات 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، تعرَّف على كيفية إنشاء مشروع و الموافقة على الطلبات. أو يمكنك الاطّلاع على مزيد من المعلومات عن الأنشطة في مرجع واجهة برمجة التطبيقات.