مقدمه ای بر 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 بخوانید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Introduction to Google Drive Activity API\n\nThe Google Drive Activity API consists of the\n[`DriveActivity`](/workspace/drive/activity/v2/reference/rest/v2/activity/driveactivity) resource, which\nrepresents changes made to objects within a user's Google Drive, and the\n[`activity.query`](/workspace/drive/activity/v2/reference/rest/v2/activity/query) method, which allows you to retrieve\ninformation about those changes.\n\nRequest\n-------\n\nYour app requests a user's activity data using the\n[`activity.query`](/workspace/drive/activity/v2/reference/rest/v2/activity/query) method. You can request activity\neither for a specific Drive item or for everything contained under a Drive\nfolder. For a given request, you can choose to restrict the response by\n[constraints](/workspace/drive/activity/v2/requests#filters) such as time range or action type, and you\ncan choose to have the activity [consolidated](/workspace/drive/activity/v2/requests#consolidation) in the\nresponse. For more information, see [Make requests in the Drive Activity API](/workspace/drive/activity/v2/requests).\n\nResponse\n--------\n\nThe response to a request is a list of activities matching the given parameters,\nwhere a\n[`DriveActivity`](/workspace/drive/activity/v2/reference/rest/v2/activity/driveactivity) resource represents each activity:\n\nA [`DriveActivity`](/workspace/drive/activity/v2/reference/rest/v2/activity/driveactivity) resource is a collection of\n[`Action`](/workspace/drive/activity/v2/reference/rest/v2/activity/action) objects, each of which is\nself-contained like an *event* . An `Action` includes an\n[`ActionDetail`](/workspace/drive/activity/v2/reference/rest/v2/activity/actiondetail) (such as `Create`\nor `Edit`), an [`Actor`](/workspace/drive/activity/v2/reference/rest/v2/activity/actor) (such as `User`\nor `Administrator`), a [`Target`](/workspace/drive/activity/v2/reference/rest/v2/activity/target) (such\nas `DriveItem` or `Drive`), and either a\n[`Timestamp`](/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)\nor [`TimeRange`](/workspace/drive/activity/v2/reference/rest/v2/activity/timerange).\n\nA `DriveActivity` resource also contains\nsummary information, such as every\n`Actor` and\n`Target` from all the actions, a unified\n`Timestamp`\nor `TimeRange`, and either the most\nimportant or representative\n`ActionDetail` of the\n`Action`.\n\nFor more information, see the [Drive Activity API data model](/workspace/drive/activity/v2/datamodel).\n\nActivity history visibility\n---------------------------\n\nSome activity on Drive may not be reported when you use this API. Whether the\nDrive Activity API reports a given change to an object depends on whether\nthe change, or information about the change, is visible to the authenticated\nuser in your application.\n\nVisibility is based on the permissions set for the object. There's several\nscenarios when files and folders are shared in Drive:\n\n- If an author shares a document, the activity history for the document is visible to not only the creator, but also to the authenticated users with whom it was shared.\n- If a document was shared with a user and then made private, the authenticated user can see all activity history while they had access and that the permissions are now restricted.\n- If a document was never shared with a user, the user can't see any activity history.\n\nGet started\n-----------\n\nTo get the most out of the Drive Activity API, integrate your app with the\n[Google Drive API](/workspace/drive/api) first. To get started with the Drive Activity API,\nlearn how to [create a project](/workspace/drive/activity/v2/guides/project) and\n[authorize requests](/workspace/guides/configure-oauth-consent). Or, dive right in and read\nabout activities in the\n[API reference](/workspace/drive/activity/v2/reference/rest/v2/activity)."]]
