発行カスタムフィールドの更新

課題のカスタムフィールドを更新するには、POST リクエストを対象の課題に送信します。課題を参照するには、課題 ID または課題のエンティティ ID を使用できます。

POST /api/issues/{issueID}?[fields]

fields 要求パラメーターで、応答として取得する、返されたエンティティの属性を指定します。例: 課題カスタムフィールドの id、name、その value のすべての属性。これは、変更が適用されたことを確認できます。

リクエストの本文で、更新する必要のある各課題のカスタムフィールドに id または name、$type、値 json を指定します。

値 json を作成するには、投稿する値（bundleElement）の ID を取得する必要があります。そのために:

対応するプロジェクトカスタムフィールドを取得します。
GET /api/admin/projects/{projectID}/customFields/{fieldID}
プロジェクトカスタムフィールドのサポートされている属性から bundle を取得します。
GET /api/admin/projects/{projectID}/customFields/{fieldID}?fields=bundle(values(id,name,$type),aggregatedUsers(id,name,$type))

最終的な要求は次のとおりです。

                    curl -X POST \
                    'https://example.youtrack.cloud/api/issues/SP-8?fields=customFields(id,name,value(avatarUrl,buildLink,color(id),fullName,id,isResolved,localizedName,login,minutes,name,presentation,text))' \
                    -H 'Accept: application/json' \
                    -H 'Authorization: Bearer <YouTrack_token>' \
                    -H 'Content-Type: application/json' \
                    -d '{
                    "customFields": [
                    {"name":"Assignee","$type":"SingleUserIssueCustomField","value":{"login":"jane.doe"}},
                    {"name":"Priority","$type":"SingleEnumIssueCustomField","value":{"name":"Major"}},
                    {"name":"Fix versions","$type":"MultiVersionIssueCustomField","value":[{"name":"2019.1"}]},
                    {"name":"Requester email","$type":"SimpleIssueCustomField","value":"test@example.com"},
                    ] }'
                

ターゲットの課題のカスタムフィールドが現在対応する値に設定されていることを確認するために、サーバーからの応答を確認しましょう。

                    {
                        "customFields":[
                            {
                                "id":"92-1",
                                "name":"Priority",
                                "value":{
                                    "localizedName":null,
                                    "color":{
                                        "id":"18"
                                    },
                                    "name":"Major",
                                    "id":"67-2"
                                }
                            },
                            ...
                            {
                                "id":"94-0",
                                "name":"Assignee",
                                "value":{
                                    "login":"jane.doe",
                                    "avatarUrl": "/hub/api/rest/avatar/90704ebe-c211-4906-a328-4f16ca82a5ea?s=48",
                                    "fullName":"Jane Doe",
                                    "name":"Jane Doe",
                                    "id":"1-3"
                                }
                            },
                            ...
                            {
                                "id":"92-4",
                                "name":"Fix versions",
                                "value":[
                                    {
                                        "id":"133-19",
                                        "name":"2019.1",
                                        "color":{
                                            "id":"3"
                                        }
                                    }
                                ]
                            }
                            ...
                            {
                                "id":"92-6",
                                "name":"Requester email",
                                "value":"test@example.com"
                            }
                            ...
                        ]
                    }
                

YouTrack 開発者ポータルヘルプ

要約

ステップバイステップ

関連ページ：