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

این سند مروری بر API فعالیت گوگل درایو ارائه می‌دهد.

رابط برنامه‌نویسی کاربردی Drive Activity به شما امکان می‌دهد رویدادهای اخیر را جستجو کنید. می‌توانید تاریخچه دقیقی از تمام فعالیت‌ها، شامل اطلاعات جزئی در مورد هر رویداد، را دریافت کنید. این برای کارهایی مانند حسابرسی مفید است زیرا می‌توانید فعالیت‌های دقیقی را که شامل اطلاعات ActionDetail ، Actor و Target است، بازیابی کنید.

رابط برنامه‌نویسی کاربردی فعالیت درایو (Drive Activity API) شامل منبع DriveActivity است که نشان‌دهنده تغییرات اعمال‌شده روی اشیاء درون گوگل درایو کاربر و متد activity.query است که به شما امکان می‌دهد اطلاعات مربوط به آن تغییرات را بازیابی کنید.

درخواست

Your app requests a user's activity data using the activity.query method. You can request activity either for a specific Drive item or for everything contained under a Drive folder. For a given request, you can choose to restrict the response by using a filter such as time range or action type, and you can choose to have the activity consolidated in the response. For more information, see Make requests in the Google Drive Activity API .

پاسخ

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

توضیح پیام بدنه پاسخ Drive Activity API.
شکل ۱. توضیح پیام بدنه پاسخ Drive Activity API.

یک منبع 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 مراجعه کنید.