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

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

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

البدء

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