プロジェクトチームにユーザーを追加する

プロジェクトチームにユーザーを追加するには:

1. チームを更新したいプロジェクトの ID を取得します。手順については、プロジェクト ID を取得するを参照してください。この例では、プロジェクト ID 0-0 を使用します。

2. 対象となる YouTrack ユーザーのエンティティ ID を取得します。

   そのためには、/api/users エンドポイントに GET リクエストを送信し、fields リクエストパラメーターに id、login、name をリストしてユーザーを識別します。対象ユーザーのログイン名または名前がわかっている場合は、query パラメーターにそれを指定することで、サーバーから返される結果を絞り込むことができます。

   例:

   curl -L -X GET 'https://example.youtrack.cloud/api/users?fields=id,name,login&query=Mad%20Max' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer <YouTrack_token>'

   応答として、サーバーは次のデータを返しました。

   [ { "login": "Mad_Max", "name": "Mad Max", "id": "1-7", "$type": "User" } ]

   対象プロジェクトとユーザーの両方のエンティティ ID が取得できたため、最後のステップに進むことができます。

3. ユーザーをプロジェクトのチームに追加します。

   そのためには、以下の YouTrack REST API エンドポイントに POST リクエストを送信する必要があります。

   <YouTrack_REST_API_URL>/admin/projects/{projectID}/team/ownUsers

   リクエストのペイロードで、ユーザーのエンティティ id を指定します。

   例:

   curl -L -X POST 'https://example.youtrack.cloud/api/admin/projects/0-0/team/ownUsers?fields=id,login,name' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer <YouTrack_token>' \ --data-raw '{"id":"1-7"}'

   このサンプルリクエストでは、チームに追加されたユーザーの詳細を確認するために、fields パラメーターも指定しています。

   応答として、サーバーは次のデータを返しました。

   { "login": "Mad_Max", "name": "Mad Max", "id": "1-7", "$type": "User" }