Tài nguyên: Nhiệm vụ
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "id": string, "etag": string, "title": string, "updated": string, "selfLink": string, "parent": string, "position": string, "notes": string, "status": string, "due": string, "completed": string, "deleted": boolean, "hidden": boolean, "links": [ { "type": string, "description": string, "link": string } ], "webViewLink": string } |
Trường | |
---|---|
kind |
Chỉ có đầu ra. Loại tài nguyên. Quyền này luôn là "tasks#task". |
id |
Giá trị nhận dạng việc cần làm. |
etag |
ETag của tài nguyên. |
title |
Tiêu đề của việc cần làm. Độ dài tối đa cho phép: 1024 ký tự. |
updated |
Chỉ có đầu ra. Thời gian sửa đổi lần gần đây nhất của việc cần làm (dưới dạng dấu thời gian RFC 3339). |
selfLink |
Chỉ có đầu ra. URL trỏ đến việc cần làm này. Dùng để truy xuất, cập nhật hoặc xoá việc cần làm này. |
parent |
Chỉ có đầu ra. Giá trị nhận dạng việc cần làm gốc. Trường này sẽ bị bỏ qua nếu đó là nhiệm vụ cấp cao nhất. Trường này ở chế độ chỉ đọc. Sử dụng phương thức "di chuyển" để di chuyển việc cần làm đó theo một tài khoản mẹ khác hoặc lên cấp cao nhất. |
position |
Chỉ có đầu ra. Chuỗi cho biết vị trí của một nhiệm vụ trong số các nhiệm vụ đồng cấp trong cùng một nhiệm vụ mẹ hoặc ở cấp cao nhất. Nếu chuỗi này lớn hơn chuỗi vị trí tương ứng của một tác vụ khác theo thứ tự từ điển học, tác vụ sẽ được đặt sau tác vụ khác trong cùng một tác vụ mẹ (hoặc ở cấp cao nhất). Sử dụng phương thức "di chuyển" để di chuyển tác vụ sang vị trí khác. |
notes |
Ghi chú mô tả việc cần làm. Không bắt buộc. Độ dài tối đa cho phép: 8192 ký tự. |
status |
Trạng thái của việc cần làm. Điều này là "needsAction" hoặc "đã hoàn tất". |
due |
Ngày đến hạn của công việc (dưới dạng dấu thời gian RFC 3339). Không bắt buộc. Ngày đến hạn chỉ ghi lại thông tin về ngày. Phần thời gian của dấu thời gian bị loại bỏ khi đặt ngày đến hạn. Bạn không thể đọc hoặc ghi thời gian của một công việc đến hạn thông qua API. |
completed |
Ngày hoàn thành của việc cần làm (dưới dạng dấu thời gian RFC 3339). Trường này sẽ bị bỏ qua nếu công việc chưa hoàn tất. |
deleted |
Cờ cho biết liệu công việc đã bị xoá hay chưa. Giá trị mặc định là False. |
links[] |
Chỉ có đầu ra. Tập hợp các đường liên kết. Bộ sưu tập này đang ở chế độ chỉ đọc. |
links[].type |
Loại đường liên kết, ví dụ: "email". |
links[].description |
Nội dung mô tả. Trong HTML nói: Mọi thứ giữa <a> và </a>. |
links[].link |
URL. |
webViewLink |
Chỉ có đầu ra. Một đường liên kết tuyệt đối đến việc cần làm trong giao diện người dùng web của Google Tasks. |
Phương thức |
|
---|---|
|
Xoá tất cả công việc đã hoàn thành khỏi danh sách công việc được chỉ định. |
|
Xoá việc cần làm đã chỉ định khỏi danh sách việc cần làm. |
|
Trả về tác vụ đã chỉ định. |
|
Tạo công việc mới trong danh sách việc cần làm đã chỉ định. |
|
Trả về tất cả công việc trong danh sách công việc được chỉ định. |
|
Di chuyển việc cần làm đã chỉ định đến một vị trí khác trong danh sách việc cần làm. |
|
Cập nhật tác vụ đã chỉ định. |
|
Cập nhật tác vụ đã chỉ định. |