این سند مروری بر API فعالیت گوگل درایو ارائه می‌دهد.
رابط برنامه‌نویسی کاربردی Drive Activity به شما امکان می‌دهد رویدادهای اخیر را جستجو کنید. می‌توانید تاریخچه دقیقی از تمام فعالیت‌ها، شامل اطلاعات جزئی در مورد هر رویداد، را دریافت کنید. این برای کارهایی مانند حسابرسی مفید است زیرا می‌توانید فعالیت‌های دقیقی را که شامل اطلاعات ActionDetail ، Actor و Target است، بازیابی کنید.
رابط برنامه‌نویسی کاربردی فعالیت درایو (Drive Activity API) شامل منبع DriveActivity است که نشان‌دهنده تغییرات اعمال‌شده روی اشیاء درون گوگل درایو کاربر و متد activity.query است که به شما امکان می‌دهد اطلاعات مربوط به آن تغییرات را بازیابی کنید.
درخواست
برنامه شما با استفاده از متد activity.query داده‌های فعالیت کاربر را درخواست می‌کند. شما می‌توانید فعالیت را برای یک آیتم خاص Drive یا برای هر چیزی که در پوشه Drive قرار دارد، درخواست کنید. برای یک درخواست مشخص، می‌توانید با استفاده از فیلتری مانند محدوده زمانی یا نوع اقدام، پاسخ را محدود کنید و می‌توانید فعالیت را در پاسخ ادغام کنید. برای اطلاعات بیشتر، به بخش «درخواست‌ها را در API فعالیت Google Drive» مراجعه کنید.
پاسخ
پاسخ شامل فهرستی از فعالیت‌هایی است که با پارامترهای داده شده مطابقت دارند، که در آن یک منبع DriveActivity نشان‌دهنده هر فعالیت است:
یک منبع 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 گزارش نشوند. اینکه آیا API تغییر خاصی را در یک شیء گزارش می‌دهد یا خیر، بستگی به این دارد که آیا آن تغییر یا اطلاعات مربوط به آن تغییر برای کاربر احراز هویت شده در برنامه شما قابل مشاهده است یا خیر.
قابلیت مشاهده بر اساس مجوزهای تعیین شده برای شیء است. چندین سناریو وجود دارد که فایل‌ها و پوشه‌ها در Drive به اشتراک گذاشته می‌شوند:
اگر نویسنده‌ای سندی را به اشتراک بگذارد، تاریخچه‌ی فعالیت آن سند هم برای سازنده و هم برای کاربرانی که سند با آنها به اشتراک گذاشته شده است، قابل مشاهده است.
اگر سندی با کاربری به اشتراک گذاشته شده و سپس خصوصی شده باشد، کاربر می‌تواند تمام تاریخچه فعالیت‌ها را از زمانی که به آن دسترسی داشته است، مشاهده کند، اما پس از محدود شدن دسترسی‌ها، دیگر نمی‌تواند آن را مشاهده کند.
اگر سندی هرگز با کاربری به اشتراک گذاشته نشده باشد، کاربر نمی‌تواند هیچ سابقه فعالیتی را مشاهده کند.
مباحث مرتبط
- برای بهره‌مندی هرچه بیشتر از Drive Activity API، ابتدا برنامه خود را با Google Drive API ادغام کنید.
- برای کسب اطلاعات بیشتر در مورد توسعه با APIهای Google Workspace، از جمله ایجاد یک پروژه یا مدیریت احراز هویت و مجوز، به «توسعه در Google Workspace» مراجعه کنید.
- برای کسب اطلاعات در مورد فعالیت‌ها، به مرجع API مراجعه کنید.