- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Nhiệm vụ
- Hãy làm thử!
Trả về tất cả công việc trong danh sách công việc được chỉ định. Không trả về những việc cần làm được giao theo mặc định (trong Tài liệu, Phòng Chat). Một người dùng có thể có tối đa 20.000 nhiệm vụ không bị ẩn trong mỗi danh sách và tối đa 100.000 nhiệm vụ cùng một lúc.
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 |
Giá trị nhận dạng danh sách việc cần làm. |
Tham số truy vấn
Tham số | |
---|---|
completedMax |
Giới hạn trên của ngày hoàn thành một việc cần làm (dưới dạng dấu thời gian RFC 3339) để lọc theo. Không bắt buộc. Lựa chọn mặc định là không lọc theo ngày hoàn thành. |
completedMin |
Giới hạn dưới của ngày hoàn thành một việc cần làm (dưới dạng dấu thời gian RFC 3339) để lọc theo. Không bắt buộc. Lựa chọn mặc định là không lọc theo ngày hoàn thành. |
dueMax |
Giới hạn trên của ngày đến hạn của công việc (dưới dạng dấu thời gian RFC 3339) để lọc theo. Không bắt buộc. Lựa chọn mặc định không phải là lọc theo ngày đến hạn. |
dueMin |
Giới hạn dưới của ngày đến hạn của công việc (dưới dạng dấu thời gian RFC 3339) để lọc theo. Không bắt buộc. Lựa chọn mặc định không phải là lọc theo ngày đến hạn. |
maxResults |
Số công việc tối đa được trả về trên một trang. Không bắt buộc. Giá trị mặc định là 20 (cho phép tối đa: 100). |
pageToken |
Mã thông báo chỉ định trang kết quả cần trả về. Không bắt buộc. |
showCompleted |
Cờ cho biết liệu công việc đã hoàn thành có được trả về trong kết quả hay không. Xin lưu ý rằng showẨn cũng phải là True để hiển thị các công việc đã 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 dành cho thiết bị di động của Google. Không bắt buộc. Giá trị mặc định là "True". |
showDeleted |
Cờ cho biết liệu công việc đã 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. |
updatedMin |
Giới hạn dưới của 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 theo. Không bắt buộc. Lựa chọn mặc định không phải là lọc theo thời gian sửa đổi gần nhất. |
showAssigned |
Không bắt buộc. Cờ cho biết liệu các công việ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 ( |
Trường | |
---|---|
kind |
Loại tài nguyên. Quyền này luôn là "tasks#tasks". |
etag |
ETag của tài nguyên. |
nextPageToken |
Mã thông báo được dùng để truy cập vào trang tiếp theo của kết quả này. |
items[] |
Tập hợp các 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 ( |
Trường | |
---|---|
kind |
Loại tài nguyên. Quyền này luôn là "tasks#tasks". |
etag |
ETag của tài nguyên. |
nextPageToken |
Mã thông báo được dùng để truy cập vào trang tiếp theo của kết quả này. |
items[] |
Tập hợp các việc cần làm. |