gws-tasks

tasks (v1)

必要條件： 閱讀 ../gws-shared/SKILL.md 以了解驗證、全域旗標與安全規則。若缺少該檔案，請執行 gws generate-skills 來建立。

gws tasks <resource> <method> [flags]

API 資源

tasklists

• delete — 刪除已驗證使用者的指定工作清單。如果清單包含已指派的工作，則已指派的工作與指派來源（文件、Chat 空間）中的原始工作都會被刪除。
• get — 傳回已驗證使用者的指定工作清單。
• insert — 建立新的工作清單，並將其加入已驗證使用者的工作清單。使用者一次最多可擁有 2000 個清單。
• list — 傳回已驗證使用者的所有工作清單。使用者一次最多可擁有 2000 個清單。
• patch — 更新已驗證使用者的指定工作清單。此方法支援修補語意。
• update — 更新已驗證使用者的指定工作清單。

tasks

• clear — 清除指定工作清單中所有已完成的工作。受影響的工作將被標記為「隱藏」，且在預設情況下，擷取工作清單的所有工作時不會再傳回。
• delete — 從工作清單中刪除指定的工作。如果該工作已指派，則已指派的工作與原始工作（在文件、Chat 空間中）都會被刪除。若僅要刪除已指派的工作，請導覽至指派來源，並從該處取消指派工作。
• get — 傳回指定的工作。
• insert — 在指定的工作清單上建立新工作。從文件或 Chat 空間指派的工作無法透過 Tasks 公開 API 插入；只能透過從文件或 Chat 空間指派來建立。使用者每個清單最多可有 20,000 個非隱藏工作，總計最多 100,000 個工作。
• list — 傳回指定工作清單中的所有工作。預設不傳回已指派的工作（來自文件、Chat 空間）。使用者每個清單最多可有 20,000 個非隱藏工作，總計最多 100,000 個工作。
• move — 將指定的工作移至目標工作清單中的另一個位置。如果未指定目標清單，則工作在目前清單內移動。這可能包括將其設為新父項下的子工作，和/或在其同層工作之間移動到不同位置。每個工作最多可有 2,000 個子工作。
• patch — 更新指定的工作。此方法支援修補語意。
• update — 更新指定的工作。

探索指令

在呼叫任何 API 方法之前，請先檢查它：

# 瀏覽資源與方法
gws tasks --help

# 檢查方法的必要參數、型別與預設值
gws schema tasks.<resource>.<method>

使用 gws schema 的輸出內容來建構你的 --params 與 --json 旗標。