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

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