Method: tasks.insert

在指定的工作清單上建立新工作。從 Google 文件或 Chat 聊天室指派的工作無法透過 Tasks Public API 插入;如要建立工作,必須先從 Google 文件或 Chat 聊天室指派工作。使用者一次最多可擁有 20,000 個非隱藏的工作,一次最多 100,000 個工作。

HTTP 要求

POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
tasklist

string

工作清單 ID。

查詢參數

參數
parent

string

父項工作 ID。如果是在頂層建立任務,就會省略這項參數。指派的工作不得為父項工作,也不能有父項工作。將父項設為指派的工作會導致要求失敗。選用。

previous

string

先前的同層工作 ID。如果工作是在同層級項目的第一個位置建立,就會省略這個參數。選用。

要求主體

要求主體包含 Task 的例項。

回應主體

如果成功,回應主體會包含新建立的 Task 例項。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/tasks

詳情請參閱授權指南