課題のリンク
RESTAPI を使用して課題をリンクします。
要約
ある課題を別の課題にリンクするには、対象の課題にコマンドを適用します。
ターゲット課題の ID とコマンドクエリを含む本文を使用して、/api/commands エンドポイントに POST リクエストを送信します。
ステップバイステップ
課題にコマンドを適用するには、次のエンドポイントに POST リクエストを送信します:
/api/commands例:
curl -X POST 'https://example.youtrack.cloud/api/commands' \ -H 'Authorization: Bearer <YouTrack_token>' \ -H 'Content-Type: application/json' \ -d '{ "query": "relates to NP-92", "issues": [ { "idReadable": "NP-113" } ] }'リクエストの本文で、コマンドクエリとこのコマンドを適用する必要のある課題の ID を渡します。
{ "query": "relates to NP-92", "issues": [ { "idReadable": "NP-113" } ] }コマンドが正常に適用されたかどうかを確認するには、エンドポイント
/api/issues/NP-113/linksに対して GET 要求を行います。ここで、NP-113はターゲット課題の ID です。リクエストの
fieldsパラメーターでリンク属性を指定します。例:
GET https://example.youtrack.cloud/api/issues/NP-113/links?fields=linkType(name,sourceToTarget,targetToSource),issues(id,idReadable,summary)予想されるサーバーの応答は次のとおりです。
[ { "linkType": { "sourceToTarget": "relates to", "targetToSource": "", "name": "Relates", "$type": "IssueLinkType" }, "issues": [ { "idReadable": "NP-92", "summary": "Failed test", "id": "99-543", "$type": "Issue" } ], "$type": "IssueLink" }, ... ]
関連ページ:
コマンドを課題に適用する
このページでは、RESTAPI を使用して YouTrack の 1 つ以上の課題にコマンドを適用する方法の例を示します。UI のコマンドと同様に、その REST API 実装により、1 つまたは複数の課題を含む操作をはるかに高速かつ簡単に実行できます。要約:課題にコマンドを適用するには、コマンドクエリと対象の課題を含むリクエストボディを添えて、リクエストをエンドポイントに送信します。オプションの属性を追加することで、コメントの追加、コメントの表示制限、通知の抑制なども可能です。ステップバイス...
コマンドリファレンス
コマンドは基本的に、1 つまたは複数の課題に一度に変更を適用する属性と値のペアの連続です。多くの場合、属性を省略して適用したい値を入力できます。YouTrack は、指定された値を使用する属性を検出し、コマンドの有効なオプションを提案します。コマンドの入力に使用する形式は、検索クエリで使用する構文と似ています。ただし、コロン、中括弧、シャープシンボルの使用規則はコマンドには適用されません。例: 割り当てられていて、タグ YouTrack モバイルに関連付けられている重要な課題を検索するには、次の検索...