Method: activity.query

پرس و جو از فعالیت های گذشته در Google Drive.

درخواست HTTP

POST https://driveactivity.googleapis.com/v2/activity:query

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "consolidationStrategy": {
    object (ConsolidationStrategy)
  },
  "pageSize": integer,
  "pageToken": string,
  "filter": string,

  // Union field key can be only one of the following:
  "itemName": string,
  "ancestorName": string
  // End of list of possible types for union field key.
}
زمینه های
consolidationStrategy

object ( ConsolidationStrategy )

جزئیات در مورد نحوه ادغام اقدامات مرتبط که فعالیت را تشکیل می دهند. اگر تنظیم نشود، اقدامات مرتبط ادغام نمی شوند.

pageSize

integer

حداقل تعداد فعالیت های مورد نظر در پاسخ؛ سرور تلاش می کند حداقل این مقدار را برگرداند. اگر سرور قبل از اتمام زمان درخواست، پاسخی جزئی آماده کند، ممکن است فعالیت‌های کمتری را برگرداند. اگر تنظیم نشود، یک مقدار پیش فرض استفاده می شود.

pageToken

string

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

filter

string

فیلتر برای مواردی که از این درخواست درخواست برگشت داده شده است. قالب رشته فیلتر دنباله ای از عبارات است که با یک "AND" اختیاری به هم می پیوندند، که در آن هر عبارت به شکل "مقدار عملگر فیلد" است.

زمینه های پشتیبانی شده:

  • time : از عملگرهای عددی بر روی مقادیر تاریخ یا بر حسب میلی ثانیه از 1 ژانویه 1970 یا در قالب RFC 3339 استفاده می کند. مثال ها:

    • time > 1452409200000 AND time <= 1492812924310
    • time >= "2016-01-10T01:02:03-05:00"

  • detail.action_detail_case : از عملگر "has" (:) و یک مقدار تکی یا لیستی از انواع کنش های مجاز در داخل پرانتز استفاده می کند که با فاصله از هم جدا شده اند. برای حذف یک نتیجه از پاسخ، یک خط فاصله ( - ) را به ابتدای رشته فیلتر اضافه کنید. مثال ها:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
key فیلد اتحادیه معیارهای اولیه در پرس و جو اگر کلیدی مشخص نشده باشد، پیش‌فرض ancestorName = items/root است. key فقط می تواند یکی از موارد زیر باشد:
itemName

string

فعالیت‌های این مورد Drive را برگردانید. قالب items/ITEM_ID است.

ancestorName

string

فعالیت‌های این پوشه Drive، به‌علاوه همه فرزندان و فرزندان را برگردانید. قالب items/ITEM_ID است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

پیام پاسخ برای پرس و جو از فعالیت Drive.

نمایندگی JSON
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
زمینه های
activities[]

object ( DriveActivity )

لیست فعالیت های درخواستی

nextPageToken

string

نشانه برای بازیابی صفحه بعدی نتایج، یا خالی کردن اگر نتایج دیگری در لیست وجود ندارد.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/drive.activity
  • https://www.googleapis.com/auth/drive.activity.readonly

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.

استراتژی تثبیت

نحوه ادغام فعالیت های فردی اگر مجموعه‌ای از فعالیت‌ها به هم مرتبط باشند، می‌توان آن‌ها را در یک فعالیت ترکیبی ادغام کرد، مثلاً یک بازیگر یک عمل مشابه را روی چندین هدف انجام می‌دهد، یا چند بازیگر که یک عمل را روی یک هدف واحد انجام می‌دهند. استراتژی قوانینی را تعریف می کند که فعالیت ها با آنها مرتبط است.

نمایندگی JSON
{

  // Union field strategy can be only one of the following:
  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
  // End of list of possible types for union field strategy.
}
زمینه های
strategy میدانی اتحادیه نحوه ادغام فعالیت های فردی strategy تنها می تواند یکی از موارد زیر باشد:
none

object ( NoConsolidation )

فعالیت های فردی ادغام نشده اند.

legacy

object ( Legacy )

فعالیت های فردی با استفاده از استراتژی میراث ادغام می شوند.

بدون تجمیع

استراتژی که هیچ یک از فعالیت های فردی را تجمیع نمی کند.

میراث

استراتژی ای که فعالیت ها را با استفاده از قوانین گروه بندی موجود در V1 Activity API قدیمی ادغام می کند. اقدامات مشابهی که در یک پنجره زمانی رخ می‌دهند را می‌توان در چندین هدف (مانند جابجایی مجموعه‌ای از فایل‌ها به طور همزمان) یا چندین بازیگر (مانند چندین کاربر که یک مورد را ویرایش می‌کنند) گروه‌بندی کرد. قوانین گروه بندی برای این استراتژی برای هر نوع اقدام خاص است.