特定の IssueWorkItem を使用した操作

作業項目へのアクセスを提供するリソース。

リソース	/api/workItems/{itemID}
返されたエンティティ	IssueWorkItem。エンティティ属性の説明については、サポートされているフィールドセクションを参照してください。
サポートされているメソッド	`GET` : 特定の IssueWorkItem を読む。

IssueWorkItem の属性

課題の作業項目を表します。

属性

このテーブルは、IssueWorkItem エンティティの属性について説明しています。

サーバーからの応答で属性を受け取るには、fields 要求パラメーターでその属性を明示的に指定してください。
属性を更新するには、POST リクエストの本文にそれを指定します。

フィールド	タイプ	説明
id	文字列	課題の作業項目の ID。`Read-only`
作成者	ユーザー	作業項目で作業が割り当てられているユーザー。`Can be null`
クリエーター	ユーザー	課題に作業項目を追加したユーザー。`Read-only` `Can be null`
テキスト	文字列	作業項目の説明。`Can be null`
textPreview	文字列	説明の解析されたプレビュー。`Read-only`
型	WorkItemType	作業項目のタイプ。`Can be null`
作成しました	Long	作業項目が作成された時刻を示すミリ秒単位のタイムスタンプ。UTC の UNIX タイムスタンプとして保存されます。
更新日	Long	作業項目の最終更新を示すミリ秒単位のタイムスタンプ。UTC の UNIX タイムスタンプとして保存されます。`Can be null`
期間	DurationValue	ワークアイテムの期間。
日付	Long	作業項目の日付と時刻を示すタイムスタンプ (ミリ秒単位)。UTC の Unix タイムスタンプとして保存されます。時刻部分は現在の日付の午前 0 時に設定されます。
課題	課題	作業項目が添付されている課題の属性を保存します。`Read-only`
属性	WorkItemAttributes の配列	作業項目の属性のリスト。`Read-only`

特定の IssueWorkItem を読む

特定の作業項目を取得します。

必須アクセス権

課題ワークアイテムへのアクセスが追加され、ワークアイテムの読み取り権限が必要です。

リクエスト構文

GET /api/workItems/{itemID}?{fields}

{itemID}	ワークアイテムのデータベース ID

リクエストパラメーター

パラメーター	タイプ	説明
フィールド	文字列	応答で返される必要がある IssueWorkItem 属性のリスト。フィールドが指定されていない場合、`entityID` のみが返されます。

サンプル

サンプルリクエスト

                    https://example.youtrack.cloud/api/workItems/115-2?fields=created,duration(presentation,minutes),author(name),creator(name),date,id
                

応答本文のサンプル

                    {
                      "duration": {
                        "minutes": 60,
                        "presentation": "1h",
                        "$type": "DurationValue"
                      },
                      "date": 1538956800000,
                      "created": 1539088817836,
                      "creator": {
                        "name": "John Doe",
                        "$type": "User"
                      },
                      "author": {
                        "name": "Jane Doe",
                        "$type": "User"
                      },
                      "id": "115-2",
                      "$type": "IssueWorkItem"
                    }
                

2025 年 5 月 23 日

YouTrack 開発者ポータルヘルプ

特定の IssueWorkItem を使用した操作

IssueWorkItem の属性

関連リソース

属性

特定の IssueWorkItem を読む

必須アクセス権

リクエスト構文

リクエストパラメーター

サンプル

サンプルリクエスト

応答本文のサンプル

関連ページ：