REST Resource: tasks

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

string

Chỉ có đầu ra. Loại tài nguyên. Quyền này luôn là "tasks#task".

id

string

Giá trị nhận dạng việc cần làm.

etag

string

ETag của tài nguyên.

title

string

Tiêu đề của việc cần làm. Độ dài tối đa cho phép: 1024 ký tự.

updated

string

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).

parent

string

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

string

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

string

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

string

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

string

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

string

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

boolean

Cờ cho biết liệu công việc đã bị xoá hay chưa. Giá trị mặc định là False.

hidden

boolean

Cờ cho biết liệu công việc có bị ẩn hay không. Đây là trường hợp nếu công việc được đánh dấu là đã hoàn thành khi danh sách công việc bị xoá lần gần đây nhất. Giá trị mặc định là False. Trường này ở chế độ chỉ đọc.

links[].type

string

Loại đường liên kết, ví dụ: "email".

links[].description

string

Nội dung mô tả. Trong HTML nói: Mọi thứ giữa <a> và </a>.

links[].link

string

URL.

Phương thức

clear

Xoá tất cả công việc đã hoàn thành khỏi danh sách công việc được chỉ định.

delete

Xoá việc cần làm đã chỉ định khỏi danh sách việc cần làm.

get

Trả về tác vụ đã chỉ định.

insert

Tạo công việc mới trong danh sách việc cần làm đã chỉ định.

list

Trả về tất cả công việc trong danh sách công việc được chỉ định.

move

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.

patch

Cập nhật tác vụ đã chỉ định.

update

Cập nhật tác vụ đã chỉ định.