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