在指定的工作清單上建立新工作。從 Google 文件或 Chat 聊天室指派的工作無法透過 Tasks Public API 插入;如要建立工作,必須先從 Google 文件或 Chat 聊天室指派工作。使用者一次最多可擁有 20,000 個非隱藏的工作,一次最多 100,000 個工作。
HTTP 要求
POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
tasklist |
工作清單 ID。 |
查詢參數
參數 | |
---|---|
parent |
父項工作 ID。如果是在頂層建立任務,就會省略這項參數。指派的工作不得為父項工作,也不能有父項工作。將父項設為指派的工作會導致要求失敗。選用。 |
previous |
先前的同層工作 ID。如果工作是在同層級項目的第一個位置建立,就會省略這個參數。選用。 |
要求主體
要求主體包含 Task
的例項。
回應主體
如果成功,回應主體會包含新建立的 Task
例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/tasks
詳情請參閱授權指南。