پرس و جو از فعالیت های گذشته در Google Drive.
درخواست HTTP
POST https://driveactivity.googleapis.com/v2/activity:query
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "consolidationStrategy": { object ( |
زمینه های | |
---|---|
consolidationStrategy | جزئیات در مورد نحوه ادغام اقدامات مرتبط که فعالیت را تشکیل می دهند. اگر تنظیم نشود، اقدامات مرتبط ادغام نمی شوند. |
pageSize | حداقل تعداد فعالیت های مورد نظر در پاسخ؛ سرور تلاش می کند حداقل این مقدار را برگرداند. اگر سرور قبل از اتمام زمان درخواست، پاسخی جزئی آماده کند، ممکن است فعالیتهای کمتری را برگرداند. اگر تنظیم نشود، یک مقدار پیش فرض استفاده می شود. |
pageToken | توکن مشخص می کند که کدام صفحه از نتایج را بازگرداند. این را روی مقدار nextPageToken برگردانده شده از پرس و جو قبلی تنظیم کنید تا صفحه نتایج زیر را بدست آورید. اگر تنظیم نشده باشد، صفحه اول نتایج برگردانده می شود. |
filter | فیلتر برای مواردی که از این درخواست درخواست برگشت داده شده است. قالب رشته فیلتر دنباله ای از عبارات است که با یک "AND" اختیاری به هم می پیوندند، که در آن هر عبارت به شکل "مقدار عملگر فیلد" است. زمینه های پشتیبانی شده:
|
key فیلد اتحادیه معیارهای اولیه در پرس و جو اگر کلیدی مشخص نشده باشد، پیشفرض ancestorName = items/root است. key فقط می تواند یکی از موارد زیر باشد: | |
itemName | فعالیتهای این مورد Drive را برگردانید. قالب |
ancestorName | فعالیتهای این پوشه Drive، بهعلاوه همه فرزندان و فرزندان را برگردانید. قالب |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
پیام پاسخ برای پرس و جو از فعالیت Drive.
نمایندگی JSON |
---|
{
"activities": [
{
object ( |
زمینه های | |
---|---|
activities[] | لیست فعالیت های درخواستی |
nextPageToken | نشانه برای بازیابی صفحه بعدی نتایج، یا خالی کردن اگر نتایج دیگری در لیست وجود ندارد. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/drive.activity
-
https://www.googleapis.com/auth/drive.activity.readonly
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
استراتژی تثبیت
نحوه ادغام فعالیت های فردی اگر مجموعهای از فعالیتها به هم مرتبط باشند، میتوان آنها را در یک فعالیت ترکیبی ادغام کرد، مثلاً یک بازیگر یک عمل مشابه را روی چندین هدف انجام میدهد، یا چند بازیگر که یک عمل را روی یک هدف واحد انجام میدهند. استراتژی قوانینی را تعریف می کند که فعالیت ها با آنها مرتبط است.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
strategy میدانی اتحادیه نحوه ادغام فعالیت های فردی strategy تنها می تواند یکی از موارد زیر باشد: | |
none | فعالیت های فردی ادغام نشده اند. |
legacy | فعالیت های فردی با استفاده از استراتژی میراث ادغام می شوند. |
بدون تجمیع
استراتژی که هیچ یک از فعالیت های فردی را تجمیع نمی کند.
میراث
استراتژی ای که فعالیت ها را با استفاده از قوانین گروه بندی موجود در V1 Activity API قدیمی ادغام می کند. اقدامات مشابهی که در یک پنجره زمانی رخ میدهند را میتوان در چندین هدف (مانند جابجایی مجموعهای از فایلها به طور همزمان) یا چندین بازیگر (مانند چندین کاربر که یک مورد را ویرایش میکنند) گروهبندی کرد. قوانین گروه بندی برای این استراتژی برای هر نوع اقدام خاص است.