REST Resource: tasks

Tài nguyên: Task
- Biểu diễn dưới dạng JSON
AssignmentInfo
- Biểu diễn dưới dạng JSON
ContextType
DriveResourceInfo
- Biểu diễn dưới dạng JSON
SpaceInfo
- Biểu diễn dưới dạng JSON
Phương thức

Tài nguyên: Task

Biểu diễn dưới dạng JSON

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, "assignmentInfo": { object (`AssignmentInfo`) } }

{
  "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,
  "assignmentInfo": {
    object (AssignmentInfo)
  }
}

Trường
`kind`	`string` Chỉ có đầu ra. Loại tài nguyên. Giá trị này luôn là "tasks#task".
`id`	`string` Giá trị nhận dạng của 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 nhiệm vụ (dưới dạng dấu thời gian RFC 3339).
`selfLink`	`string` 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`	`string` Chỉ có đầu ra. Mã nhận dạng của nhiệm vụ mẹ. Trường này sẽ bị bỏ qua nếu đó là một việc cần làm cấp cao nhất. Sử dụng phương thức "move" để di chuyển nhiệm vụ sang một nhiệm vụ mẹ khác hoặc lên cấp cao nhất. Việc cần làm chính không bao giờ có thể là việc cần làm được giao (từ phòng Chat, Tài liệu). Trường này ở chế độ chỉ đọc.
`position`	`string` Chỉ có đầu ra. Chuỗi cho biết vị trí của việc cần làm trong số các việc cần làm ngang cấp trong cùng một việc cần làm 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, thì tác vụ này sẽ được đặt sau tác vụ kia trong cùng một tác vụ mẹ (hoặc ở cấp cao nhất). Sử dụng phương thức "move" để di chuyển tác vụ đến một vị trí khác.
`notes`	`string` Ghi chú mô tả việc cần làm. Việc cần làm được giao qua Google Tài liệu không thể có ghi chú. 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. Giá trị này là "needsAction" hoặc "completed".
`due`	`string` Ngày được lên lịch cho việc cần làm (dưới dạng dấu thời gian RFC 3339). Không bắt buộc. Đây là ngày mà bạn cần hoàn thành việc cần làm hoặc ngày mà việc cần làm xuất hiện trên lưới lịch. Đây không phải là thời hạn của việc cần làm. Hệ thống 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 bạn đặt trường này. Bạn không thể đọc hoặc ghi thời gian lên lịch cho một việc cần làm bằng API.
`completed`	`string` Ngày hoàn thành 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 việc cần làm chưa hoàn tất.
`deleted`	`boolean` Cờ cho biết liệu việc cần làm đã bị xoá hay chưa. Đối với các việc cần làm được giao, trường này ở chế độ chỉ đọc. Bạn chỉ có thể xoá việc cần làm được giao bằng cách gọi tasks.delete. Trong trường hợp này, cả việc cần làm được giao và việc cần làm ban đầu (trong Tài liệu hoặc không gian trong Chat) đều sẽ bị xoá. Để chỉ xoá việc cần làm được giao, hãy chuyển đến giao diện bài tập và huỷ giao việc cần làm tại đó. Giá trị mặc định là False.
`hidden`	`boolean` Cờ cho biết liệu việc cần làm có bị ẩn hay không. Điều này xảy ra nếu việc cần làm đã được đánh dấu là hoàn tất khi danh sách việc cần làm được xoá lần gần đây nhất. Giá trị mặc định là False. Trường này ở chế độ chỉ đọc.
`links[]`	`object` Chỉ có đầu ra. Bộ sưu tập đường liên kết. Bộ sưu tập này ở chế độ chỉ đọc.
`links[].type`	`string` Loại đường liên kết, ví dụ: "email", "chung", "tin_nhắn_trò_chuyện", "ghi_chú_keep".
`links[].description`	`string` Nội dung mô tả (có thể trống).
`links[].link`	`string` URL.
`webViewLink`	`string` Chỉ có đầu ra. Đườ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.
`assignmentInfo`	`object (AssignmentInfo)` Chỉ có đầu ra. Thông tin theo bối cảnh cho các việc cần làm được giao. Bạn có thể giao việc cần làm cho người dùng, hiện có thể thực hiện trên các nền tảng như Tài liệu và không gian Chat. Trường này được điền sẵn cho những việc cần làm được giao cho người dùng hiện tại và xác định nơi giao việc cần làm. Trường này ở chế độ chỉ đọc.

AssignmentInfo

Thông tin về nguồn gốc của việc giao việc cần làm (Tài liệu, Phòng Chat).

Biểu diễn dưới dạng JSON

Biểu diễn dưới dạng JSON
{ "linkToTask": string, "surfaceType": enum (`ContextType`), // Union field `surface_info` can be only one of the following: "driveResourceInfo": { object (`DriveResourceInfo`) }, "spaceInfo": { object (`SpaceInfo`) } // End of list of possible types for union field `surface_info`. }

{
  "linkToTask": string,
  "surfaceType": enum (ContextType),

  // Union field surface_info can be only one of the following:
  "driveResourceInfo": {
    object (DriveResourceInfo)
  },
  "spaceInfo": {
    object (SpaceInfo)
  }
  // End of list of possible types for union field surface_info.
}

Trường
`linkToTask`	`string` Chỉ có đầu ra. Đường liên kết tuyệt đối đến việc cần làm ban đầu trong giao diện của bài tập (Tài liệu, không gian Chat, v.v.).
`surfaceType`	`enum (ContextType)` Chỉ có đầu ra. Loại nền tảng mà nhiệm vụ được giao này bắt nguồn. Hiện chỉ giới hạn ở DOCUMENT hoặc SPACE.
Trường nhóm `surface_info`. Thông tin về nền tảng (Tài liệu, Không gian Chat) nơi việc cần làm này được giao. `surface_info` chỉ có thể là một trong những trạng thái sau:
`driveResourceInfo`	`object (DriveResourceInfo)` Chỉ có đầu ra. Thông tin về tệp trên Drive mà từ đó bắt nguồn nhiệm vụ này. Hiện tại, tệp Drive chỉ có thể là một tài liệu. Trường này ở chế độ chỉ đọc.
`spaceInfo`	`object (SpaceInfo)` Chỉ có đầu ra. Thông tin về phòng Chat nơi bắt nguồn việc cần làm này. Trường này ở chế độ chỉ đọc.

ContextType

Sản phẩm được liên kết với nhiệm vụ.

Enum
`CONTEXT_TYPE_UNSPECIFIED`	Giá trị không xác định cho bối cảnh của tác vụ này.
`GMAIL`	Việc cần làm được tạo từ Gmail.
`DOCUMENT`	Việc cần làm được giao trong một tài liệu.
`SPACE`	Việc cần làm được giao thông qua một phòng Chat.

DriveResourceInfo

Thông tin về tài nguyên trên Drive nơi việc cần làm được giao (tài liệu, trang tính, v.v.).

Biểu diễn dưới dạng JSON
{ "driveFileId": string, "resourceKey": string }

Trường

Trường
`driveFileId`	`string` Chỉ có đầu ra. Mã nhận dạng của tệp trong Drive API.
`resourceKey`	`string` Chỉ có đầu ra. Bạn cần có khoá tài nguyên để truy cập vào các tệp được chia sẻ qua đường liên kết dùng chung. Không bắt buộc đối với tất cả các tệp. Xem thêm tại developers.google.com/drive/api/guides/resource-keys.

driveFileId

string

Chỉ có đầu ra. Mã nhận dạng của tệp trong Drive API.

resourceKey

string

Chỉ có đầu ra. Bạn cần có khoá tài nguyên để truy cập vào các tệp được chia sẻ qua đường liên kết dùng chung. Không bắt buộc đối với tất cả các tệp. Xem thêm tại developers.google.com/drive/api/guides/resource-keys.

SpaceInfo

Thông tin về phòng Chat nơi việc cần làm được giao.

Biểu diễn dưới dạng JSON
{ "space": string }

Trường

Trường
`space`	`string` Chỉ có đầu ra. Phòng Chat nơi việc cần làm này xuất phát. Định dạng là "spaces/{space}".

space

string

Chỉ có đầu ra. Phòng Chat nơi việc cần làm này xuất phát. Định dạng là "spaces/{space}".

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á việc cần làm đã chỉ định khỏi danh sách việc cần làm.
`get`	Trả về nhiệm vụ được chỉ định.
`insert`	Tạo một việc cần làm mới trong danh sách việc cần làm đã chỉ định.
`list`	Trả về tất cả việc cần làm trong danh sách việc cần làm đã chỉ định.
`move`	Di chuyển việc cần làm được chỉ định đến một vị trí khác trong danh sách việc cần làm đích.
`patch`	Cập nhật việc cần làm được chỉ định.
`update`	Cập nhật việc cần làm được chỉ định.

REST Resource: tasks

Tài nguyên: Task

AssignmentInfo

ContextType

DriveResourceInfo

SpaceInfo

Phương thức

`clear`

`delete`

`get`

`insert`

`list`

`move`

`patch`

`update`

REST Resource: tasks Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Tài nguyên: Task

AssignmentInfo

ContextType

DriveResourceInfo

SpaceInfo

Phương thức

REST Resource: tasks