Method: tasks.list

Trả về tất cả việc cần làm trong danh sách việc cần làm đã chỉ định. Không trả về việc cần làm được giao theo mặc định (từ Tài liệu, Phòng Chat). Mỗi người dùng có thể có tối đa 20.000 việc cần làm không bị ẩn trong mỗi danh sách và tổng cộng tối đa 100.000 việc cần làm tại một thời điểm.

Yêu cầu HTTP

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

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

Tham số đường dẫn

Tham số
tasklist

string

Giá trị nhận dạng danh sách việc cần làm.

Tham số truy vấn

Tham số
completedMax

string

Giới hạn trên cho ngày hoàn thành của một việc cần làm (dưới dạng dấu thời gian RFC 3339) để lọc. Không bắt buộc. Theo mặc định, bạn không lọc theo ngày hoàn thành.

completedMin

string

Giới hạn dưới của ngày hoàn thành việc cần làm (dưới dạng dấu thời gian RFC 3339) để lọc. Không bắt buộc. Chế độ mặc định là không lọc theo ngày hoàn thành.

dueMax

string

Giới hạn trên cho ngày đến hạn của một việc cần làm (dưới dạng dấu thời gian RFC 3339) để lọc. Không bắt buộc. Theo mặc định, bạn không lọc theo ngày đến hạn.

dueMin

string

Giới hạn dưới của ngày đến hạn của một việc cần làm (dưới dạng dấu thời gian RFC 3339) để lọc. Không bắt buộc. Theo mặc định, bạn không lọc theo ngày đến hạn.

maxResults

integer

Số lượng tác vụ tối đa được trả về trên một trang. Không bắt buộc. Giá trị mặc định là 20 (tối đa cho phép: 100).

pageToken

string

Mã thông báo chỉ định trang kết quả cần trả về. Không bắt buộc.

showCompleted

boolean

Cờ cho biết liệu các tác vụ đã hoàn thành có được trả về trong kết quả hay không. Xin lưu ý rằng showHidden cũng phải là True để hiển thị các việc cần làm đã hoàn thành trong ứng dụng của bên thứ nhất, chẳng hạn như giao diện người dùng web và ứng dụng di động của Google. Không bắt buộc. Giá trị mặc định là True.

showDeleted

boolean

Cờ cho biết liệu các việc cần làm đã xoá có được trả về trong kết quả hay không. Không bắt buộc. Giá trị mặc định là False.

showHidden

boolean

Cờ cho biết liệu các tác vụ ẩn có được trả về trong kết quả hay không. Không bắt buộc. Giá trị mặc định là False.

updatedMin

string

Giới hạn dưới cho thời gian sửa đổi gần đây nhất của một tác vụ (dưới dạng dấu thời gian RFC 3339) để lọc. Không bắt buộc. Theo mặc định, bạn không lọc theo thời gian sửa đổi gần đây nhất.

showAssigned

boolean

Không bắt buộc. Cờ cho biết liệu các tác vụ được giao cho người dùng hiện tại có được trả về trong kết quả hay không. Không bắt buộc. Giá trị mặc định là False.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

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:

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

string

Loại tài nguyên. Mã này luôn là "tasks#tasks".

etag

string

ETag của tài nguyên.

nextPageToken

string

Mã thông báo dùng để truy cập vào trang tiếp theo của kết quả này.

items[]

object (Task)

Bộ sưu tập việc cần làm.

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/tasks
  • https://www.googleapis.com/auth/tasks.readonly

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

Tasks

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

string

Loại tài nguyên. Mã này luôn là "tasks#tasks".

etag

string

ETag của tài nguyên.

nextPageToken

string

Mã thông báo dùng để truy cập vào trang tiếp theo của kết quả này.

items[]

object (Task)

Bộ sưu tập việc cần làm.