تتكون واجهة برمجة تطبيقات أنشطة 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، وإما الأكثر
مهم أو ممثل
ActionDetail من
Action
لمزيد من المعلومات، يُرجى الاطّلاع على نموذج بيانات واجهة برمجة تطبيقات النشاط في Drive.
إذن الوصول إلى "سجلّ النشاط"
قد لا يتم الإبلاغ عن بعض الأنشطة على Drive عند استخدام واجهة برمجة التطبيقات هذه. سواء كانت تعرض واجهة برمجة التطبيقات لنشاط Drive تغييرًا معينًا لعنصر يعتمد على ما إذا كان أن يكون التغيير أو المعلومات المتعلقة به مرئية بالنسبة إلى مستخدم تمت مصادقته المستخدم في تطبيقك.
يستند مستوى الرؤية إلى الأذونات التي تم ضبطها للعنصر. تتوفر العديد من الحالات التي تتم فيها مشاركة الملفات والمجلدات في Drive:
- في حال شارك مؤلِّف مستندًا، يتم عرض سجلّ النشاط للمستند لا يظهر لصانع المحتوى فحسب، بل أيضًا للمستخدمين الذين تمت مصادقتهم ومع من تمت مشاركتها.
- إذا تمت مشاركة مستند مع مستخدم ثم جعله خاصًا، فإن يمكن أن يطّلع المستخدم على سجلّ النشاط بالكامل عندما يكون لديه إذن الوصول، وأن الأذونات متاحة الآن. مقيَّد.
- في حال عدم مشاركة مستند مع مستخدم مطلقًا، لن يتمكّن المستخدم من الاطّلاع على أي نشاط السجل.
البدء
للاستفادة إلى أقصى حد من واجهة برمجة تطبيقات النشاط في Drive، يمكنك دمج تطبيقك مع Google Drive API أولاً. لبدء استخدام Drive Activity API، تعرَّف على كيفية إنشاء مشروع تفويض الطلبات. أو البدء والقراءة عن الأنشطة في مرجع واجهة برمجة التطبيقات.