- 资源:任务
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- AssignmentInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- ContextType
- DriveResourceInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- SpaceInfo
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 方法
资源:任务
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 ( |
字段 | |
---|---|
kind |
仅限输出。资源的类型。始终为“tasks#task”。 |
id |
任务标识符。 |
etag |
资源的 ETag。 |
title |
任务的标题。允许的长度上限:1024 个字符。 |
updated |
仅限输出。任务的上次修改时间(以 RFC 3339 时间戳表示)。 |
selfLink |
仅限输出。指向此任务的网址。用于检索、更新或删除此任务。 |
parent |
仅限输出。父级任务标识符。如果它是顶级任务,则省略此字段。使用“移动”方法将任务移至其他父级或顶级。绝不会是父级任务(来自 Chat 聊天室、Google 文档)。此字段为只读字段。 |
position |
仅限输出。字符串,指示同一任务在同一父级任务下或位于顶级任务的同级任务中的位置。如果此字符串大于另一任务的相应位置字符串(按字典顺序排列),则该任务将在同一父任务下(或顶级)排在另一个任务之后。使用“移动”方法将任务移到其他位置。 |
notes |
任务说明。通过 Google 文档分配的任务不能包含备注。可选。允许的长度上限:8192 个字符。 |
status |
任务的状态。可以是“needsAction”即“completed” |
due |
任务的截止日期(以 RFC 3339 时间戳表示)。可选。截止日期仅记录日期信息;在设置截止日期时,时间戳的时间部分会被舍弃。您无法通过该 API 读取或写入任务的截止时间。 |
completed |
任务的完成日期(以 RFC 3339 时间戳表示)。如果任务尚未完成,则省略此字段。 |
deleted |
此标记指示任务是否已删除。对于已分配的任务,此字段为只读字段。您只能通过调用 tasks.delete 来删除任务,在这种情况下,已分配的任务和(Google 文档或 Chat 聊天室中)的原始任务都会被删除。如需仅删除已分配的任务,请前往作业界面,然后在该界面中取消分配任务。默认值为 False。 |
links[] |
仅限输出。链接的集合。此集合是只读集合。 |
links[].type |
链接类型,例如“email”。 |
links[].description |
说明。使用 HTML 语言:<a>和 </a>。 |
links[].link |
网址。 |
webViewLink |
仅限输出。指向 Google Tasks 网页界面中相应任务的绝对链接。 |
assignmentInfo |
仅限输出。已分配任务的上下文信息。可以将任务分配给用户,目前可以通过文档和 Chat 聊天室等途径实现。对于分配给当前用户的任务,此字段会填入此字段,用于标识任务的分配位置。此字段为只读字段。 |
AssignmentInfo
任务分配来源(文档、Chat 聊天室)的相关信息。
JSON 表示法 |
---|
{ "linkToTask": string, "surfaceType": enum ( |
字段 | |
---|---|
linkToTask |
仅限输出。作业界面(文档、Chat 聊天室等)中指向原始任务的绝对链接。 |
surfaceType |
仅限输出。生成此分配任务的途径类型。目前仅限在 DOCUMENT 或 SPACE 中使用。 |
联合字段 surface_info 。分配此任务的途径(文档、Chat 聊天室)的相关信息。surface_info 只能是下列其中一项: |
|
driveResourceInfo |
仅限输出。生成此任务的云端硬盘文件的相关信息。目前,云端硬盘文件只能是文档。此字段为只读字段。 |
spaceInfo |
仅限输出。发起此任务的 Chat 聊天室的相关信息。此字段为只读字段。 |
ContextType
与任务关联的产品。
枚举 | |
---|---|
CONTEXT_TYPE_UNSPECIFIED |
此任务上下文的未知值。 |
GMAIL |
任务是通过 Gmail 创建的。 |
DOCUMENT |
任务是通过文档分配的。 |
SPACE |
任务是通过 Chat 聊天室分配的。 |
DriveResourceInfo
分配任务的云端硬盘资源(文档、工作表等)的相关信息。
JSON 表示法 |
---|
{ "driveFileId": string, "resourceKey": string } |
字段 | |
---|---|
driveFileId |
仅限输出。Drive API 中文件的标识符。 |
resourceKey |
仅限输出。必须提供资源密钥,才能访问通过共享链接共享的文件。并非所有文件都需要。另请参阅 developers.google.com/drive/api/guides/resource-keys。 |
SpaceInfo
分配任务的 Chat 聊天室的相关信息。
JSON 表示法 |
---|
{ "space": string } |
字段 | |
---|---|
space |
仅限输出。发起此任务的 Chat 聊天室。格式为“spaces/{space}”。 |
方法 |
|
---|---|
|
清除指定任务列表中所有已完成的任务。 |
|
从任务列表中删除指定任务。 |
|
返回指定的任务。 |
|
在指定的任务列表上创建新任务。 |
|
返回指定任务列表中的所有任务。 |
|
将指定任务移至目标任务列表中的其他位置。 |
|
更新指定的任务。 |
|
更新指定的任务。 |