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

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

الطلب

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

الرد

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

شرح نشاط Drive.

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