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

Loại tài nguyên. Mục này luôn là "tasks#task".
id

string

Mã nhận dạng việc cần làm.
etag

string

Thẻ ETag của tài nguyên.
title

string

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

string

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

string

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

string

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

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. Thao tác này có thể là "Cần Hành động" hoặc "Đã hoàn tất".
due

string

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

string

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

boolean

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

boolean

Cờ cho biết liệu tác vụ có bị ẩn hay không. Trường hợp này xảy ra 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ỉ để đọc.
links[].type

string

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

string

Nội dung mô tả. Trong HTML, hãy nói: Mọi thứ từ <a> và </a>.
links[].link

string

URL.

Phương thức

clear

 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.

delete

 Xoá công việc đã chỉ định khỏi danh sách công việc.

get

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

insert

 Tạo một công việc mới trên danh sách công việc đã 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 công việc được chỉ định đến một vị trí khác trong danh sách công việc.

patch

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

update

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