Method: activity.query

Truy vấn hoạt động trước đây trong Google Drive.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "consolidationStrategy": {
    object (ConsolidationStrategy)
  },
  "pageSize": integer,
  "pageToken": string,
  "filter": string,

  "itemName": string,
  "ancestorName": string
}
Trường
consolidationStrategy

object (ConsolidationStrategy)

Thông tin chi tiết về cách hợp nhất các hành động liên quan tạo nên hoạt động. Nếu bạn không đặt giá trị này, các hành động liên quan sẽ không được hợp nhất.
pageSize

integer

Số lượng hoạt động tối thiểu mong muốn trong phản hồi; máy chủ cố gắng trả về ít nhất số lượng này. Máy chủ cũng có thể trả về ít hoạt động hơn nếu có phản hồi một phần trước khi yêu cầu hết thời gian chờ. Nếu bạn không đặt, hệ thống sẽ sử dụng giá trị mặc định.
pageToken

string

Mã thông báo này xác định trang kết quả cần trả về. Đặt giá trị này thành giá trị nextPageToken được trả về từ một truy vấn trước đó để nhận trang kết quả tiếp theo. Nếu bạn không đặt tham số này, trang kết quả đầu tiên sẽ được trả về.
filter

string

Bộ lọc cho các mục được trả về từ yêu cầu truy vấn này. Định dạng của chuỗi bộ lọc là một chuỗi các biểu thức, được kết hợp bằng "AND" (không bắt buộc), trong đó mỗi biểu thức có dạng "field operator value" (giá trị toán tử trường).

Các trường được hỗ trợ:

  • time: Sử dụng các toán tử số trên giá trị ngày theo đơn vị mili giây kể từ ngày 1 tháng 1 năm 1970 hoặc theo định dạng RFC 3339. Ví dụ:

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

  • detail.action_detail_case: Sử dụng toán tử "has" (:) và một giá trị đơn lẻ hoặc danh sách các loại hành động được phép đặt trong dấu ngoặc đơn, phân tách bằng dấu cách. Để loại trừ một kết quả khỏi câu trả lời, hãy thêm dấu gạch nối (-) vào đầu chuỗi bộ lọc. Ví dụ:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
Trường nhóm key. Tiêu chí chính trong truy vấn. Giá trị mặc định là ancestorName = items/root, nếu không có khoá nào được chỉ định. key chỉ có thể là một trong những trạng thái sau:
itemName

string

Trả về các hoạt động cho mục này trên Drive. Định dạng là items/ITEM_ID.
ancestorName

string

Trả về hoạt động cho thư mục này trên Drive, cộng với tất cả các thư mục con và thư mục cháu. Định dạng là items/ITEM_ID.

Nội dung phản hồi

Thông báo phản hồi cho việc truy vấn hoạt động trên Drive.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
Trường
activities[]

object (DriveActivity)

Danh sách hoạt động được yêu cầu.
nextPageToken

string

Mã thông báo để truy xuất trang kết quả tiếp theo hoặc mã thông báo trống nếu không còn kết quả nào trong danh sách.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

ConsolidationStrategy

Cách hợp nhất các hoạt động riêng lẻ. Nếu có liên quan, bạn có thể hợp nhất một nhóm hoạt động thành một hoạt động kết hợp, chẳng hạn như một diễn viên thực hiện cùng một hành động trên nhiều mục tiêu hoặc nhiều diễn viên thực hiện cùng một hành động trên một mục tiêu duy nhất. Chiến lược này xác định các quy tắc về những hoạt động có liên quan.

Biểu diễn dưới dạng JSON 
{

  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
}
Trường
Trường nhóm strategy. Cách hợp nhất các hoạt động riêng lẻ. strategy chỉ có thể là một trong những trạng thái sau:
none

object (NoConsolidation)

Các hoạt động riêng lẻ không được hợp nhất.
legacy

object (Legacy)

Các hoạt động riêng lẻ được hợp nhất bằng chiến lược cũ.

NoConsolidation

Loại này không có trường nào.

Một chiến lược không hợp nhất các hoạt động riêng lẻ.

Cũ

Loại này không có trường nào.

Một chiến lược hợp nhất các hoạt động bằng cách sử dụng các quy tắc nhóm từ Activity API phiên bản 1 cũ. Các thao tác tương tự xảy ra trong một khoảng thời gian có thể được nhóm trên nhiều mục tiêu (chẳng hạn như di chuyển một nhóm tệp cùng một lúc) hoặc nhiều đối tượng (chẳng hạn như nhiều người dùng chỉnh sửa cùng một mục). Quy tắc nhóm cho chiến lược này dành riêng cho từng loại hành động.