Sử dụng tham số tác vụ
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Ngoài các tham số truy vấn chuẩn có thể dùng với hầu hết các API của Google, bạn cũng có thể tham khảo một tập hợp tham số Tasks.
Bảng dưới đây tóm tắt các tham số yêu cầu chỉ áp dụng cho một số thao tác cụ thể trong API Google Tasks. Tất cả giá trị thông số cần phải được mã hóa URL.
| Thông số |
Ý nghĩa |
Ghi chú |
Khả năng áp dụng |
completedMax |
Giới hạn trên cho ngày hoàn thành một tác vụ (dưới dạng dấu thời gian RFC 3339) để lọc. |
- Mặc định:
completedMax=2031-01-01
- Hãy dùng định dạng dấu thời gian RFC 3339. Ví dụ:
2010-08-09T10:57:00.000-08:00
|
|
completedMin |
Giới hạn dưới cho 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. |
- Mặc định:
completedMin=1970-01-01
- Hãy dùng định dạng dấu thời gian RFC 3339. Ví dụ:
2010-08-09T10:57:00.000-08:00
|
|
dueMax |
Giới hạn trên cho ngày đến hạn của một tác vụ (dưới dạng dấu thời gian RFC 3339) để lọc. |
- Mặc định:
dueMax=2031-01-01
- Hãy dùng định dạng dấu thời gian RFC 3339. Ví dụ:
2010-08-09T10:57:00.000-08:00
|
|
dueMin |
Giới hạn dưới 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. |
- Mặc định:
dueMin=1970-01-01
- Hãy dùng định dạng dấu thời gian RFC 3339. Ví dụ:
2010-08-09T10:57:00.000-08:00
|
|
maxResults |
Số lượng phần tử tối đa cần trả về với yêu cầu này. |
- Mặc định:
maxResults=20
- Giá trị tối đa cho phép:
maxResults=100.
|
- Truy xuất danh sách tác vụ của người dùng
- Đang truy xuất tác vụ
|
pageToken |
Mã thông báo chỉ định trang kết quả để trả về. |
- Tùy chọn mặc định là trả về trang đầu tiên.
|
- Truy xuất danh sách tác vụ của người dùng
- Đang truy xuất tác vụ
|
parent |
Chỉ định mã tác vụ mẹ của việc cần làm. |
- Không có thông số nào cho biết việc chèn hoặc chuyển đến cấp cao nhất của danh sách việc cần làm.
|
- Tạo việc cần làm
- Sắp xếp việc cần làm
|
previous |
Chỉ định mã nhiệm vụ trước đó của việc cần làm. |
- Không có tham số nào cho biết việc chèn hoặc di chuyển đến vị trí đầu tiên trong danh sách phụ.
|
- Tạo việc cần làm
- Sắp xếp việc cần làm
|
showCompleted |
Chỉ định xem có hiển thị các việc cần làm đã hoàn thành hay không. |
- Mặc định:
showCompleted=true
|
|
showDeleted |
Chỉ định xem có hiển thị các việc cần làm bị xoá hay không. |
- Mặc định:
showDeleted=false
|
|
showHidden |
Chỉ định xem có hiển thị các việc cần làm bị ẩn hay không. |
- Mặc định:
showHidden=true
|
|
updatedMin |
Giới hạn dưới cho thời gian sửa đổi lần 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. |
- Hãy dùng định dạng dấu thời gian RFC 3339. Ví dụ:
2010-08-09T10:57:00.000-08:00Z.
- Tuỳ chọn mặc định không lọc theo thời gian sửa đổi gần nhất.
|
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[],[],null,["# Use Tasks Parameters\n\nIn addition to the standard query parameters that can be used with most Google APIs, there is a set of Tasks parameters.\n\nRequest parameters that apply only to specific operations in the Google Tasks API are summarized in the following table. All parameter values need to be URL encoded.\n\n| Parameter | Meaning | Notes | Applicability |\n|-----------------|------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|\n| `completedMax` | Upper bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `completedMin` | Lower bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMax` | Upper bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMin` | Lower bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `maxResults` | The maximum number of elements to return with this request. | - Default: `maxResults=20` - Maximum allowable value: `maxResults=100.` | - Retrieving a user's task lists - Retrieving tasks |\n| `pageToken` | Token specifying the result page to return. | - The default is to return the first page. | - Retrieving a user's task lists - Retrieving tasks |\n| `parent` | Specify the task's parent task ID. | - No parameter indicates an insertion or a move to the top level of the task list. | - Creating a task - Ordering a task |\n| `previous` | Specify the task's previous task ID. | - No parameter indicates an insertion or a move to the first position in the sublist. | - Creating a task - Ordering a task |\n| `showCompleted` | Specify whether or not to show completed tasks. | - Default: `showCompleted=true` | - Retrieving tasks |\n| `showDeleted` | Specify whether or not to show deleted tasks. | - Default: `showDeleted=false` | - Retrieving tasks |\n| `showHidden` | Specify whether or not to show hidden tasks. | - Default: `showHidden=true` | - Retrieving tasks |\n| `updatedMin` | Lower bound for a task's last modification time (as an RFC 3339 timestamp) to filter by. | - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00Z`. - The default is not to filter by last modification time. | - Retrieving tasks |"]]
