مقدمه ای بر Google Drive Activity API

Google Drive Activity API متشکل از منبع DriveActivity است که نشان دهنده تغییرات ایجاد شده در اشیاء در Google Drive کاربر و روش activity.query است که به شما امکان می دهد اطلاعات مربوط به آن تغییرات را بازیابی کنید.

درخواست کنید

برنامه شما با استفاده از روش activity.query داده های فعالیت کاربر را درخواست می کند. می‌توانید برای یک مورد خاص Drive یا برای هر چیزی که در پوشه Drive وجود دارد، فعالیت درخواست کنید. برای یک درخواست مشخص، می‌توانید پاسخ را با محدودیت‌هایی مانند محدوده زمانی یا نوع عمل محدود کنید، و می‌توانید انتخاب کنید که فعالیت در پاسخ ادغام شود. برای اطلاعات بیشتر، به ایجاد درخواست در Drive Activity API مراجعه کنید.

پاسخ

پاسخ به یک درخواست، فهرستی از فعالیت‌های منطبق با پارامترهای داده شده است، که در آن یک منبع DriveActivity هر فعالیت را نشان می‌دهد:

توضیح فعالیت درایو

منبع DriveActivity مجموعه ای از اشیاء Action است که هر کدام مانند یک رویداد مستقل هستند. یک Action شامل ActionDetail (مانند Create یا Edit )، یک Actor (مانند User یا Administrator )، یک Target (مانند DriveItem یا Drive ) و یک Timestamp یا TimeRange است.

یک منبع DriveActivity همچنین حاوی اطلاعات خلاصه‌ای است، مانند هر Actor و Target از همه اقدامات، یک Timestamp یا TimeRange یکپارچه، و یا مهم‌ترین یا نماینده ActionDetail از Action .

برای اطلاعات بیشتر، مدل داده API Activity Drive را ببینید.

قابلیت مشاهده سابقه فعالیت

هنگام استفاده از این API ممکن است برخی از فعالیت‌ها در Drive گزارش نشود. اینکه Drive Activity API یک تغییر معین را به یک شی گزارش می‌دهد یا نه، بستگی به این دارد که آیا تغییر یا اطلاعات مربوط به تغییر، برای کاربر تأیید شده در برنامه شما قابل مشاهده باشد.

قابلیت مشاهده بر اساس مجوزهای تنظیم شده برای شی است. زمانی که فایل‌ها و پوشه‌ها در Drive به اشتراک گذاشته می‌شوند، چندین سناریو وجود دارد:

  • اگر نویسنده سندی را به اشتراک بگذارد، سابقه فعالیت برای سند نه تنها برای سازنده، بلکه برای کاربران احراز هویتی که با آنها به اشتراک گذاشته شده است نیز قابل مشاهده است.
  • اگر سندی با کاربر به اشتراک گذاشته شده باشد و سپس خصوصی شود، کاربر احراز هویت شده می‌تواند تمام سابقه فعالیت را در زمانی که دسترسی داشته است ببیند و اکنون مجوزها محدود شده‌اند.
  • اگر سندی هرگز با کاربر به اشتراک گذاشته نشده باشد، کاربر نمی‌تواند سابقه فعالیتی را ببیند.

شروع کنید

برای استفاده حداکثری از Drive Activity API، ابتدا برنامه خود را با Google Drive API یکپارچه کنید. برای شروع کار با Drive Activity API، نحوه ایجاد پروژه و مجوز دادن به درخواست‌ها را بیاموزید. یا مستقیماً وارد شوید و درباره فعالیت‌ها در مرجع API بخوانید.