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,

  // Union field key can be only one of the following:
  "itemName": string,
  "ancestorName": string
  // End of list of possible types for union field key.
}
Các 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 sẽ tạo nên hoạt động đó. Nếu bạn không đặt chính sách này, thì các hành động có 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 chính sách này, hệ thống sẽ sử dụng giá trị mặc định.
pageToken

string

Mã thông báo 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ả sau. Nếu bạn không đặt chính sách này, hệ thống sẽ trả về trang kết quả đầu tiên.
filter

string

Lọc 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 biểu thức, kết hợp bằng "AND" không bắt buộc, trong đó mỗi biểu thức đều có dạng "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 các giá trị ngày theo mili giây kể từ ngày 1 tháng 1 năm 1970 hoặc ở đị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ị số ít hoặc danh sách các loại thao tác được phép đặt trong ngoặc đơn, phân tách bằng dấu cách. Để loại trừ một kết quả khỏi phản hồ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 chỉ định khoá. key chỉ có thể là một trong những trạng thái sau đây:
itemName

string

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

string

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

Nội dung phản hồi

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:

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

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

object (DriveActivity)

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

string

Mã thông báo để truy xuất trang kết quả tiếp theo hoặc để trống nếu không có kết quả nào khác 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 một nhóm hoạt động có liên quan với nhau, thì bạn có thể hợp nhất chúng thành một hoạt động kết hợp, chẳng hạn như một người thực hiện cùng một hành động trên nhiều mục tiêu hoặc nhiều người thực hiện cùng một hành động trên một mục tiêu. Chiến lược này xác định các quy tắc cho những hoạt động có liên quan.

Biểu diễn dưới dạng 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.
}
Các 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 đây:
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

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

Cũ

Chiến lược hợp nhất các hoạt động bằng cách sử dụng quy tắc nhóm từ API Hoạt động phiên bản 1 cũ. Các hành động 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 các tệp cùng một lúc) hoặc nhiều người thực hiện (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.