Sử dụng tham số tác vụ
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: 2024-09-03 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-09-03 UTC."],[[["In addition to standard query parameters, the Google Tasks API utilizes specific parameters for refined task management."],["These parameters control filtering by due dates, completion dates, modification times, and the visibility of completed, deleted, or hidden tasks."],["Developers can use these parameters to retrieve specific sets of tasks based on various criteria, such as completion status and due dates, using RFC 3339 timestamps for filtering."],["Parameters like `maxResults` and `pageToken` allow for pagination and control over the number of tasks returned in a response."],["The `parent` and `previous` parameters enable developers to manage task hierarchy and ordering within task lists."]]],["The Google Tasks API uses specific parameters for operations, all of which require URL encoding. These parameters filter tasks by `completedMin/Max`, `dueMin/Max`, and `updatedMin` date ranges using RFC 3339 timestamps. `maxResults` limits the number of returned items, and `pageToken` specifies the result page. `parent` and `previous` parameters determine task order, while `showCompleted`, `showDeleted`, and `showHidden` control the visibility of tasks. These parameters apply to retrieving tasks and task lists, creating, and ordering tasks.\n"]]