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

يقدّم هذا المستند نظرة عامة على Google Drive Activity API.

تتيح لك واجهة برمجة التطبيقات Drive Activity API طلب البحث عن الأحداث الأخيرة. يمكنك استرداد سجلّ مفصّل لجميع الأنشطة، بما في ذلك معلومات دقيقة عن كل حدث. ويفيد ذلك في مهام مثل عمليات التدقيق، إذ يمكنك استرداد أنشطة دقيقة تتضمّن المعلومات ActionDetail وActor وTarget.

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

طلب

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

الردّ

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

شرح لرسالة نص الأساسية في استجابة Drive Activity API
الشكل 1. شرح لرسالة نص الأساسية في استجابة Drive Activity API

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.
  • للتعرّف على كيفية التطوير باستخدام واجهات برمجة التطبيقات في Google Workspace، بما في ذلك إنشاء مشروع أو التعامل مع المصادقة والتفويض، يُرجى الرجوع إلى التطوير على Google Workspace.
  • للاطّلاع على معلومات عن الأنشطة، يُرجى الرجوع إلى مرجع واجهة برمجة التطبيقات.