تتكون واجهة برمجة تطبيقات نشاط Google Drive من مورد DriveActivity، الذي يمثل التغييرات التي تم إجراؤها على العناصر ضمن Google Drive للمستخدم، والطريقة activity.query التي تتيح لك استرداد المعلومات حول هذه التغييرات.
طلب
يطلب تطبيقك بيانات نشاط المستخدم باستخدام طريقة
activity.query. يمكنك طلب نشاط إما لعنصر Drive معين أو لكل عنصر ضمن مجلد Drive. بالنسبة إلى طلب معيّن، يمكنك اختيار تقييد الاستجابة حسب القيود مثل النطاق الزمني أو نوع الإجراء، كما يمكنك اختيار دمج النشاط في الاستجابة. لمعرفة مزيد من المعلومات، يُرجى الاطِّلاع على إنشاء طلبات في واجهة برمجة تطبيقات أنشطة Drive.
الإجابة
تتمثل الاستجابة إلى الطلب في قائمة من الأنشطة المتطابقة مع المعلمات المحددة، حيث يمثل مورد DriveActivity كل نشاط:
مورد DriveActivity هو مجموعة من كائنات
Action، يكون كل منها
منفردًا مثل حدث. تتضمن Action
ActionDetail (مثل Create
أو Edit)، وActor (مثل User
أو Administrator)، وTarget (مثل DriveItem أو Drive)، وإما Timestamp
أو TimeRange.
كما يحتوي مورد DriveActivity أيضًا على معلومات تلخيصية، مثل كل Actor وTarget من كل الإجراءات، بالإضافة إلى Timestamp موحّد أو TimeRange، وكذلك أهم أو ممثل من ActionDetailAction.
لمعرفة مزيد من المعلومات، يُرجى الاطِّلاع على نموذج بيانات واجهة برمجة تطبيقات نشاط Drive.
إمكانية رؤية سجلّ الأنشطة
قد لا يتم الإبلاغ عن بعض الأنشطة على Drive عند استخدام واجهة برمجة التطبيقات هذه. تعتمد إمكانية الإبلاغ عن تغيير ما على كائن ما على ما إذا كان التغيير، أو المعلومات حول التغيير، مرئية للمستخدم الذي تمت مصادقته في تطبيقك أم لا.
تعتمد إمكانية الظهور على الأذونات التي تم ضبطها للعنصر. هناك العديد من السيناريوهات عند مشاركة الملفات والمجلدات في Drive:
- إذا شارك مؤلف مستندًا، سيكون سجلّ النشاط للمستند مرئيًا ليس لمنشئ المحتوى فقط، ولكن أيضًا للمستخدمين الذين تمت مصادقتهم والذين تمت مشاركته معهم.
- إذا تمت مشاركة مستند مع مستخدم ثم تم جعله خاصًا، فيمكن للمستخدم الذي تمت مصادقته الاطلاع على سجلّ الأنشطة بالكامل أثناء تمكنه من الوصول، وأن الأذونات أصبحت مقيّدة الآن.
- إذا لم تتم مشاركة مستند مع أحد المستخدمين مطلقًا، فلا يمكن للمستخدم الاطلاع على أي سجلّ لنشاط.
البدء
للاستفادة إلى أقصى حد من واجهة برمجة تطبيقات أنشطة Drive، يمكنك دمج تطبيقك مع واجهة برمجة تطبيقات Google Drive أولاً. لبدء استخدام واجهة برمجة تطبيقات أنشطة Drive، تعرَّف على كيفية إنشاء مشروع وتفويض الطلبات. أو، يمكنك الاطلاع على المزيد حول الأنشطة والاطلاع عليها في مرجع واجهة برمجة التطبيقات.