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

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

الطلب

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

الإجابة

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

شرح نشاط Drive.

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على نموذج بيانات واجهة برمجة تطبيقات نشاط Drive.

إذن الوصول إلى سجلّ النشاط

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

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

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

البدء

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