REST Resource: tasks

Tài nguyên: Việc cần làm

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)
  }
}
Trường
kind

string

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

string

Giá trị nhận dạng tác vụ.
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 được phép: 1024 ký tự.
updated

string

Chỉ có đầu ra. Thời gian sửa đổi gần đây nhất của tác vụ (dưới dạng dấu thời gian RFC 3339).
parent

string

Chỉ có đầu ra. Mã nhận dạng tác 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 "di chuyển" để di chuyển tác vụ sang một tác vụ mẹ khác hoặc lên cấp cao nhất. Việc cần làm mẹ không bao giờ được là việc cần làm được giao (từ phòng Chat, Tài liệu). Trường này chỉ có thể đọc.
position

string

Chỉ có đầu ra. Chuỗi cho biết vị trí của tác vụ trong số các tác vụ đồng cấp thuộc 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 tác vụ khác theo thứ tự từ vựng, thì tác vụ này 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 công việc sang 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 từ Google Tài liệu không thể có ghi chú. Không bắt buộc. Độ dài tối đa được phép: 8192 ký tự.
status

string

Trạng thái của tác vụ. Đây là "needsAction" hoặc "completed".
due

string

Ngày đến hạn của việc cần làm (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 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. Bạn không thể đọc hoặc ghi thời gian đến hạn của một việc cần làm thông qua 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 việc cần làm đã bị xoá hay chưa. Đối với việc cần làm được giao, trường này ở chế độ chỉ đọc. Bạn chỉ có thể xoá các việc cần làm này 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 Chat) đều bị xoá. Để chỉ xoá bài tập được giao, hãy chuyển đến giao diện bài tập rồi huỷ giao bài tập đó. Giá trị mặc định là False.
hidden

boolean

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

string

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

string

Nội dung mô tả (có thể để trống).
links[].link

string

URL.
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 một người dùng. Hiện tại, bạn có thể thực hiện việc này trên các nền tảng như Tài liệu và Không gian trò chuyện. Trường này được điền sẵn cho các 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ỉ có thể đọc.

AssignmentInfo

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

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.
}
Trường
surfaceType

enum (ContextType)

Chỉ có đầu ra. Loại nền tảng mà tác vụ được chỉ định này bắt nguồn. Hiện chỉ giới hạn ở DOCUMENT hoặc SPACE.
Trường hợp hợp nhất surface_info. Thông tin về nền tảng (Tài liệu, Phòng Chat) nơi giao việc cần làm này. surface_info chỉ có thể là một trong những giá trị sau:
driveResourceInfo

object (DriveResourceInfo)

Chỉ có đầu ra. Thông tin về tệp trên Drive mà tác vụ này bắt nguồn. Hiện tại, tệp trên Drive chỉ có thể là tài liệu. Trường này chỉ có thể đọc.
spaceInfo

object (SpaceInfo)

Chỉ có đầu ra. Thông tin về Phòng Chat nơi bắt nguồn của việc cần làm này. Trường này chỉ có thể đọc.

ContextType

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

Enum
CONTEXT_TYPE_UNSPECIFIED Giá trị không xác định cho ngữ 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 từ một tài liệu.
SPACE Việc cần làm được giao từ một Phòng Chat.

DriveResourceInfo

Thông tin về tài nguyên trên Drive nơi một 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
driveFileId

string

Chỉ có đầu ra. Giá trị nhận dạng của tệp trong API Drive.
resourceKey

string

Chỉ có đầu ra. 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 được chia sẻ. Không bắt buộc đối với tất cả tệp. Xem thêm developers.google.com/drive/api/guides/resource-keys.

SpaceInfo

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

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

string

Chỉ có đầu ra. Phòng Chat nơi việc cần làm này bắt nguồn. Đị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 đã 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 một việc cần làm mới trên 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 đã chỉ định sang 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 đã chỉ định.

update

 Cập nhật việc cần làm đã chỉ định.