مقدّمة حول 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 Activity API تبلِّغ عن تغيير معيَّن لأحد العناصر بناءً على ما إذا كان التغيير أو المعلومات المتعلقة بالتغيير مرئية للمستخدم الذي تمت مصادقته في تطبيقك أم لا.

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

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

البدء

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