タスクAPI (/ tasks)
ユーザーAPIを使用すると、ユーザーを作成、更新、またはクエリできます。
概要
Task APIを使用すると、標準のGET、PUT、POST、およびDELETEアクションを実行できます。また、独自のエンドポイント/projects /{ project_id }/ tasksおよび/user_groups /{ user_group_id }/ tasksを介して、プロジェクトまたはグループに関連付けられているタスクにアクセスすることもできます 。
詳細については、統合のベストプラクティスを参照してください。
アクション
タスクAPIを使用すると、次のことができます。
| 動詞 | パス | アクション | 説明 |
|---|---|---|---|
| 投稿 |
/api/user_groups /: user_group_id/tasks
|
作成 | グループタスクを作成 |
| 投稿 |
/api/projects /: project_id/tasks
|
作成 | プロジェクトタスクを作成 |
| 投稿 |
/api/tasks
|
作成 | タスクを作成 |
| 削除 |
/api/projects /: project_id/tasks /: id
|
削除 | プロジェクトタスクを削除 |
| 削除 |
/api/tasks /: id
|
削除 | タスクを削除 |
| 取得 |
/api/user_groups /: user_group_id/tasks
|
index | グループタスクを問い合わせ |
| 取得 |
/api/projects /: project_id/tasks
|
index | プロジェクトタスクを問い合わせ |
| 取得 |
/api/tasks
|
index | タスクを問い合わせ |
| 取得 |
/api/user_groups /: user_group_id/tasks /: id
|
表示 | グループタスクを表示 |
| 取得 |
/api/projects /: project_id/tasks /: id
|
表示 | プロジェクトのタスクを表示 |
| 取得 |
/api/tasks /: id
|
表示 | タスクの表示 |
| パッチ |
/api/user_groups /: user_group_id/tasks /: id
|
更新 | グループタスクの更新 |
| プット |
/api/user_groups /: user_group_id/tasks /: id
|
update | グループタスクの更新 |
| パッチ |
/api/projects /: project_id/tasks /: id
|
更新 | プロジェクトタスクを更新 |
| プット |
/api/projects /: project_id/tasks /: id
|
更新 | プロジェクトタスクを更新 |
| パッチ |
/api/tasks /: id
|
更新 | タスクの更新 |
| プット |
/api/tasks /: id
|
update | タスクを更新 |
要素
次の要素は、タスクAPIで使用できます。
| 要素 | 説明 | 必須フィールドですか？ | 一意ですか？ | 許容値 | Api_Inフィールド？ | Api_Outフィールド？ | データタイプ |
|---|---|---|---|---|---|---|---|
| created - at | CoupaがYYY - MM - DDTHH: MM: SS + HH: MMZの形式で自動的に作成しました | はい | 日時 | ||||
| created - by | 作成したユーザー | はい | ユーザー | ||||
| 説明 | 説明 | はい | はい | テキスト | |||
| due - date | 期日 | はい | はい | 日時 | |||
| duration | duration | はい | はい | float | |||
| iD | Coupaの一意の識別子 | はい | 整数 | ||||
| リンク可能 | タスクがリンクされている関連付け。可能な値はUserGroup/Projectです | はい | はい | タスク | |||
| linkable - id | タスクがリンクされているユーザーグループまたはプロジェクトのID | はい | はい | 整数 | |||
| linkable - type | リンクされたオブジェクトの種類。タスクcnはユーザーグループまたはプロジェクトにリンクされます | はい | はい | string (255) | |||
| 所有者 | 所有者 | はい | はい | ユーザー | |||
| owner - id | タスクが割り当てられているユーザーID | はい | はい | 整数 | |||
| パーセンテージ | パーセンテージ | 0 ～ 100 | はい | はい | 整数 | ||
| resolved - at | タスクが解決されたタイムスタンプの形式はYYYYY - MM - DDTHH: MM: SS + HH: MMZ | はい | 日時 | ||||
| resolved - by | タスクを解決したユーザー | はい | ユーザー | ||||
| start - date | 開始日 | はい | はい | 日時 | |||
| ステータス | タスクのステータス | はい | はい | string (255) | |||
| task - id | 編集不可能なタスクの一意の識別子。これは自動生成されます。これは、ローダーでタスクを更新する一意の識別子として使用されます | はい | 整数 | ||||
| タイトル | タイトル | はい | はい | はい | string (255) | ||
| updated - at | CoupaがYYY - MM - DDTHH: MM: SS + HH: MMZの形式で自動的に作成しました | はい | 日時 | ||||
| 更新者： | 更新したユーザー | はい | ユーザー |