{"id":21446,"date":"2023-01-30T05:11:55","date_gmt":"2023-01-30T05:11:55","guid":{"rendered":"https:\/\/44.225.35.201\/testrail\/docs\/801\/api-manual\/reference\/users\/"},"modified":"2023-09-16T21:33:57","modified_gmt":"2023-09-16T12:33:57","slug":"api-users","status":"publish","type":"page","link":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/api-manual\/reference\/api-users\/","title":{"rendered":"\u30e6\u30fc\u30b6\u30fc"},"content":{"rendered":"

\u30e6\u30fc\u30b6\u30fc\u306b\u95a2\u3059\u308b\u60c5\u5831\u3092\u53d6\u5f97\u3059\u308b\u306b\u306f\u3001\u6b21\u306e API \u30e1\u30bd\u30c3\u30c9\u3092\u4f7f\u7528\u3057\u307e\u3059\u3002<\/p>\n

\n
\n

get_user<\/h2>\n
\n
\n

\u65e2\u5b58\u306e\u30e6\u30fc\u30b6\u30fc\u3092\u8fd4\u3057\u307e\u3059\u3002<\/p>\n

GET index.php?\/api\/v2\/get_user\/{user_id}<\/pre>\n<\/div>\n<\/div>\n
\n
\n
\u30d1\u30e9\u30e1\u30fc\u30bf\u30fc<\/h3>\n\n\n\n\n\n
\u540d\u524d<\/th>\n\u30bf\u30a4\u30d7<\/th>\n\u5fc5\u9808<\/th>\n\u8aac\u660e<\/th>\n<\/tr>\n<\/thead>\n
user_id<\/td>\ninteger<\/td>\ntrue<\/td>\n\u30e6\u30fc\u30b6\u30fc\u306e ID<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n
\n
\u30ec\u30b9\u30dd\u30f3\u30b9\u306e\u5185\u5bb9 (TestRail Professional)<\/h3>\n<\/div>\n<\/div>\n
\n
\n
{\n    \"id\": 1,\n    \"email\": \"john.doe@gurock.io\",\n    \"email_notifications\": true,\n    \"is_active\": true,\n    \"is_admin\": false,\n    \"name\": \"John Doe\",\n    \"role_id\": 3,\n    \"role\": \"Tester\",\n    \"group_ids\": [1, 2, 3],\n    \"mfa_required\": false\n}<\/pre>\n<\/div>\n<\/div>\n
\n
\n
\u30ec\u30b9\u30dd\u30f3\u30b9\u306e\u5185\u5bb9 (TestRail Enterprise)<\/h3>\n<\/div>\n<\/div>\n
\n
\n
{\n    \"id\": 1,\n    \"email\": \"john.doe@gurock.io\",\n    \"email_notifications\": true,\n    \"is_active\": true,\n    \"is_admin\": false,\n    \"name\": \"John Doe\",\n    \"role_id\": 3,\n    \"role\": \"Tester\",\n    \"group_ids\": [1, 2, 3],\n    \"mfa_required\": false,\n    \"sso_enabled\": true,\n    \"assigned_projects\": [1, 3]\n}<\/pre>\n<\/div>\n<\/div>\n
\n
\n
\u30ec\u30b9\u30dd\u30f3\u30b9\u306b\u306f\u6b21\u306e\u30d5\u30a3\u30fc\u30eb\u30c9\u304c\u542b\u307e\u308c\u307e\u3059\u3002<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\u540d\u524d<\/th>\n\u30bf\u30a4\u30d7<\/th>\n\u8aac\u660e<\/th>\n<\/tr>\n<\/thead>\n
assigned_projects<\/td>\narray<\/td>\n\u30d7\u30ed\u30b8\u30a7\u30af\u30c8 ID \u306e\u914d\u5217\u5404 ID\u306f\u3001\u30e6\u30fc\u30b6\u30fc\u304c\u95a2\u9023\u4ed8\u3051\u3089\u308c\u3066\u3044\u308b\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u306e ID \u3067\u3059\u3002\u8a73\u7d30\u306f\u30d7\u30ed\u30b8\u30a7\u30af\u30c8 \u30ec\u30d9\u30eb\u306e\u7ba1\u7406\u3092\u53c2\u7167\u3057\u3066\u304f\u3060\u3055\u3044 (TestRail Enterprise 7.3 \u4ee5\u964d\u304c\u5fc5\u8981<\/strong>)\u3002<\/td>\n<\/tr>\n
email<\/td>\nstring<\/td>\nTestRail \u3067\u8a2d\u5b9a\u3055\u308c\u305f\u30e6\u30fc\u30b6\u30fc\u306e E-mail \u30a2\u30c9\u30ec\u30b9<\/td>\n<\/tr>\n
email_notifications<\/td>\nboolean<\/td>\n\u30e6\u30fc\u30b6\u30fc\u306e E-mail \u901a\u77e5\u304c\u6709\u52b9\u306a\u5834\u5408\u306f true (TestRail 7.3 \u4ee5\u964d\u304c\u5fc5\u8981<\/strong>)\u3002<\/td>\n<\/tr>\n
id<\/td>\ninteger<\/td>\n\u30e6\u30fc\u30b6\u30fc\u306e\u4e00\u610f\u306e ID<\/td>\n<\/tr>\n
is_active<\/td>\nboolean<\/td>\n\u30e6\u30fc\u30b6\u30fc\u304c\u30a2\u30af\u30c6\u30a3\u30d6\u3067\u3042\u308b\u5834\u5408\u306f true\u3001\u305d\u3046\u3067\u306a\u3044\u5834\u5408\u306f false<\/td>\n<\/tr>\n
is_admin<\/td>\nboolean<\/td>\n\u30e6\u30fc\u30b6\u30fc\u304c TestRail \u7ba1\u7406\u8005\u3067\u3042\u308b\u5834\u5408\u306f true (TestRail 7.3 \u4ee5\u964d\u304c\u5fc5\u8981<\/strong>)\u3002<\/td>\n<\/tr>\n
group_ids<\/td>\narray<\/td>\n\u30b0\u30eb\u30fc\u30d7 ID \u306e\u914d\u5217\u5404 ID\u306f\u3001\u30e6\u30fc\u30b6\u30fc\u304c\u5272\u308a\u5f53\u3066\u3089\u308c\u3066\u3044\u308b\u30b0\u30eb\u30fc\u30d7\u306e ID \u3067\u3059 (TestRail 7.3 \u4ee5\u964d\u304c\u5fc5\u8981<\/strong>)\u3002<\/td>\n<\/tr>\n
mfa_required<\/td>\nboolean<\/td>\n\u30e6\u30fc\u30b6\u30fc \u30d7\u30ed\u30d5\u30a1\u30a4\u30eb\u3067\u30ed\u30b0\u30a4\u30f3\u3054\u3068\u306b MFA \u304c\u5fc5\u8981\u3068\u8a2d\u5b9a\u3055\u308c\u3066\u3044\u308b\u5834\u5408\u306f true (TestRail 7.3 \u4ee5\u964d\u304c\u5fc5\u8981<\/strong>)\u3002<\/td>\n<\/tr>\n
name<\/td>\nstring<\/td>\n\u30e6\u30fc\u30b6\u30fc\u306e\u30d5\u30eb \u30cd\u30fc\u30e0<\/td>\n<\/tr>\n
role_id<\/td>\ninteger<\/td>\n\u30e6\u30fc\u30b6\u30fc\u306e\u30b0\u30ed\u30fc\u30d0\u30eb\u306b\u5272\u308a\u5f53\u3066\u3089\u308c\u305f\u30ed\u30fc\u30eb\u306e ID (TestRail 6.4 \u4ee5\u964d\u304c\u5fc5\u8981<\/strong>)<\/td>\n<\/tr>\n
role<\/td>\nstring<\/td>\n\u30e6\u30fc\u30b6\u30fc\u306e\u30b0\u30ed\u30fc\u30d0\u30eb\u306b\u5272\u308a\u5f53\u3066\u3089\u308c\u305f\u30ed\u30fc\u30eb\u306e\u540d\u524d (TestRail 6.4 \u4ee5\u964d\u304c\u5fc5\u8981<\/strong>)<\/td>\n<\/tr>\n
sso_enabled<\/td>\nboolean<\/td>\n\u30e6\u30fc\u30b6\u30fc\u306e\u30d7\u30ed\u30d5\u30a1\u30a4\u30eb\u3067\u30b7\u30f3\u30b0\u30eb\u30b5\u30a4\u30f3\u30aa\u30f3\u304c\u6709\u52b9\u306a\u5834\u5408\u306f true (TestRail Enterprise 7.3 \u4ee5\u964d\u304c\u5fc5\u8981<\/strong>)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\u3059\u3079\u3066\u306e\u30e6\u30fc\u30b6\u30fc\u306f\u81ea\u5206\u81ea\u8eab\u306e\u30a2\u30ab\u30a6\u30f3\u30c8\u60c5\u5831\u3092\u53d6\u5f97\u3067\u304d\u307e\u3059\u3002\u4ed6\u306e\u30e6\u30fc\u30b6\u30fc\u306e\u60c5\u5831\u3092\u53d6\u5f97\u3059\u308b\u306b\u306f\u7ba1\u7406\u8005\u30a2\u30af\u30bb\u30b9\u6a29\u304c\u5fc5\u8981\u3067\u3059\u3002<\/strong><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\u30ec\u30b9\u30dd\u30f3\u30b9 \u30b3\u30fc\u30c9<\/h3>\n\n\n\n\n\n\n\n
\u30b9\u30c6\u30fc\u30bf\u30b9 \u30b3\u30fc\u30c9<\/th>\n\u8aac\u660e<\/th>\n<\/tr>\n<\/thead>\n
200<\/td>\n\u6210\u529f\u3002\u30e6\u30fc\u30b6\u30fc\u304c\u30ec\u30b9\u30dd\u30f3\u30b9\u306e\u4e00\u90e8\u3068\u3057\u3066\u8fd4\u3055\u308c\u307e\u3059<\/td>\n<\/tr>\n
400<\/td>\n\u7121\u52b9\u307e\u305f\u306f\u4e0d\u660e\u306a\u30e6\u30fc\u30b6\u30fc<\/td>\n<\/tr>\n
429<\/td>\nTestRail Cloud \u306e\u307f – <\/strong>\u30ea\u30af\u30a8\u30b9\u30c8\u304c\u591a\u3059\u304e\u307e\u3059<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
get_current_user<\/h2>\n
<\/p>\n
\n
TestRail 6.6 \u4ee5\u964d\u304c\u5fc5\u8981\u3067\u3059\u3002<\/strong><\/p>\n<\/div>\n
<\/p>\n
\n
\n
API \u30ea\u30af\u30a8\u30b9\u30c8\u3092\u884c\u3063\u3066\u3044\u308b TestRail \u30e6\u30fc\u30b6\u30fc\u306e\u8a73\u7d30\u3092\u8fd4\u3057\u307e\u3059\u3002<\/p>\n<\/div>\n<\/div>\n
\n
\n
GET index.php?\/api\/v2\/get_current_user\/{user_id}<\/pre>\n<\/div>\n<\/div>\n
\u30d1\u30e9\u30e1\u30fc\u30bf\u30fc<\/h3>\n\n\n\n\n\n
\u540d\u524d<\/th>\n\u30bf\u30a4\u30d7<\/th>\n\u5fc5\u9808<\/th>\n\u8aac\u660e<\/th>\n<\/tr>\n<\/thead>\n
user_id<\/td>\ninteger<\/td>\ntrue<\/td>\n\u30e6\u30fc\u30b6\u30fc\u306e ID<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n
\n
\u30ec\u30b9\u30dd\u30f3\u30b9\u306e\u5185\u5bb9<\/h3>\n<\/div>\n<\/div>\n
\n
\n
{\n    \"id\": 1,\n    \"email\": \"john.doe@gurock.io\",\n    \"is_active\": true,\n    \"name\": \"John Doe\",\n    \"role_id\": 3,\n    \"role\": \"Tester\"\n}<\/pre>\n<\/div>\n<\/div>\n
\n
\n
\u30ec\u30b9\u30dd\u30f3\u30b9\u306b\u306f\u6b21\u306e\u30d5\u30a3\u30fc\u30eb\u30c9\u304c\u542b\u307e\u308c\u307e\u3059\u3002<\/p>\n
\n
\n
\n
\n
\n
\n\n\n\n\n\n\n\n\n\n\n
\u540d\u524d<\/th>\n\u30bf\u30a4\u30d7<\/th>\n\u8aac\u660e<\/th>\n<\/tr>\n<\/thead>\n
email<\/td>\nstring<\/td>\nTestRail \u3067\u8a2d\u5b9a\u3055\u308c\u305f\u30e6\u30fc\u30b6\u30fc\u306e E-mail \u30a2\u30c9\u30ec\u30b9<\/td>\n<\/tr>\n
id<\/td>\ninteger<\/td>\n\u30e6\u30fc\u30b6\u30fc\u306e\u4e00\u610f\u306e ID<\/td>\n<\/tr>\n
is_active<\/td>\nboolean<\/td>\n\u30e6\u30fc\u30b6\u30fc\u304c\u30a2\u30af\u30c6\u30a3\u30d6\u3067\u3042\u308b\u5834\u5408\u306f true\u3001\u305d\u3046\u3067\u306a\u3044\u5834\u5408\u306f false<\/td>\n<\/tr>\n
name<\/td>\nstring<\/td>\n\u30e6\u30fc\u30b6\u30fc\u306e\u30d5\u30eb \u30cd\u30fc\u30e0<\/td>\n<\/tr>\n
role_id<\/td>\ninteger<\/td>\n\u30e6\u30fc\u30b6\u30fc\u306e\u30b0\u30ed\u30fc\u30d0\u30eb\u306b\u5272\u308a\u5f53\u3066\u3089\u308c\u305f\u30ed\u30fc\u30eb\u306e ID (TestRail 6.4 \u4ee5\u964d\u304c\u5fc5\u8981<\/strong>)<\/td>\n<\/tr>\n
role<\/td>\nstring<\/td>\n\u30e6\u30fc\u30b6\u30fc\u306e\u30b0\u30ed\u30fc\u30d0\u30eb\u306b\u5272\u308a\u5f53\u3066\u3089\u308c\u305f\u30ed\u30fc\u30eb\u306e\u540d\u524d (TestRail 6.4 \u4ee5\u964d\u304c\u5fc5\u8981<\/strong>)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\u3059\u3079\u3066\u306e\u30e6\u30fc\u30b6\u30fc\u306f\u81ea\u5206\u81ea\u8eab\u306e\u30a2\u30ab\u30a6\u30f3\u30c8\u60c5\u5831\u3092\u53d6\u5f97\u3067\u304d\u307e\u3059\u3002\u4ed6\u306e\u30e6\u30fc\u30b6\u30fc\u306e\u60c5\u5831\u3092\u53d6\u5f97\u3059\u308b\u306b\u306f\u7ba1\u7406\u8005\u30a2\u30af\u30bb\u30b9\u6a29\u304c\u5fc5\u8981\u3067\u3059\u3002<\/strong><\/p>\n<\/div>\n
\u30ec\u30b9\u30dd\u30f3\u30b9 \u30b3\u30fc\u30c9<\/h3>\n<\/div>\n<\/div>\n
\n\n\n\n\n\n\n\n
\u30b9\u30c6\u30fc\u30bf\u30b9 \u30b3\u30fc\u30c9<\/th>\n\u8aac\u660e<\/th>\n<\/tr>\n<\/thead>\n
200<\/td>\n\u6210\u529f\u3002\u30e6\u30fc\u30b6\u30fc\u304c\u30ec\u30b9\u30dd\u30f3\u30b9\u306e\u4e00\u90e8\u3068\u3057\u3066\u8fd4\u3055\u308c\u307e\u3059<\/td>\n<\/tr>\n
400<\/td>\n\u7121\u52b9\u307e\u305f\u306f\u4e0d\u660e\u306a\u30e6\u30fc\u30b6\u30fc<\/td>\n<\/tr>\n
429<\/td>\nTestRail Cloud \u306e\u307f \u2013\u00a0<\/span><\/strong>\u30ea\u30af\u30a8\u30b9\u30c8\u304c\u591a\u3059\u304e\u307e\u3059<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
\n
\n
\n
\n
get_user_by_email<\/h2>\n
\u96fb\u5b50\u30e1\u30fc\u30eb\u30a2\u30c9\u30ec\u30b9\u3067\u691c\u7d22\u3057\u305f\u65e2\u5b58\u306e\u30e6\u30fc\u30b6\u30fc\u3092\u8fd4\u3057\u307e\u3059\u3002<\/p>\n
\n
\n
GET index.php?\/api\/v2\/get_user_by_email&email={email}<\/pre>\n<\/div>\n<\/div>\n
\n
\n
\u30d1\u30e9\u30e1\u30fc\u30bf\u30fc<\/h3>\n\n\n\n\n\n
\u540d\u524d<\/th>\n\u30bf\u30a4\u30d7<\/th>\n\u5fc5\u9808<\/th>\n\u8aac\u660e<\/th>\n<\/tr>\n<\/thead>\n
email<\/td>\nstring<\/td>\ntrue<\/td>\n\u53d6\u5f97\u3059\u308b\u30e6\u30fc\u30b6\u30fc\u306e\u96fb\u5b50\u30e1\u30fc\u30eb \u30a2\u30c9\u30ec\u30b9<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\u3053\u306e\u30e1\u30bd\u30c3\u30c9\u306f get_user<\/a> \u3068\u540c\u3058\u30ec\u30b9\u30dd\u30f3\u30b9 \u30d5\u30a9\u30fc\u30de\u30c3\u30c8\u3092\u4f7f\u7528\u3057\u307e\u3059\u3002<\/p>\n
\n
\u3059\u3079\u3066\u306e\u30e6\u30fc\u30b6\u30fc\u306f\u81ea\u5206\u81ea\u8eab\u306e\u30a2\u30ab\u30a6\u30f3\u30c8\u60c5\u5831\u3092\u53d6\u5f97\u3067\u304d\u307e\u3059\u3002\u4ed6\u306e\u30e6\u30fc\u30b6\u30fc\u306e\u60c5\u5831\u3092\u53d6\u5f97\u3059\u308b\u306b\u306f\u7ba1\u7406\u8005\u30a2\u30af\u30bb\u30b9\u6a29\u304c\u5fc5\u8981\u3067\u3059\u3002<\/strong><\/p>\n<\/div>\n
\u30ec\u30b9\u30dd\u30f3\u30b9 \u30b3\u30fc\u30c9<\/h3>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n\n\n\n\n\n\n\n
\u30b9\u30c6\u30fc\u30bf\u30b9 \u30b3\u30fc\u30c9<\/th>\n\u8aac\u660e<\/th>\n<\/tr>\n<\/thead>\n
200<\/td>\n\u6210\u529f\u3002\u30e6\u30fc\u30b6\u30fc\u304c\u30ec\u30b9\u30dd\u30f3\u30b9\u306e\u4e00\u90e8\u3068\u3057\u3066\u8fd4\u3055\u308c\u307e\u3059<\/td>\n<\/tr>\n
400\/404<\/td>\n\u7121\u52b9\u307e\u305f\u306f\u4e0d\u660e\u306a\u96fb\u5b50\u30e1\u30fc\u30eb \u30a2\u30c9\u30ec\u30b9<\/td>\n<\/tr>\n
429<\/td>\nTestRail Cloud \u306e\u307f \u2013\u00a0<\/span><\/strong>\u30ea\u30af\u30a8\u30b9\u30c8\u304c\u591a\u3059\u304e\u307e\u3059<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
<\/div>\n
\n
\n
\n
\n
\n
\n
\n
\n
get_users<\/h2>\n
\u30e6\u30fc\u30b6\u30fc\u306e\u30ea\u30b9\u30c8\u3092\u8fd4\u3057\u307e\u3059\u3002<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
GET index.php?\/api\/v2\/get_users\nGET index.php?\/api\/v2\/get_users\/{project_id}<\/pre>\n
[et_pb_text admin_label=”Note” _builder_version=”4.4.2″ background_color=”#ffffdd” hover_enabled=”0″ border_width_all=”1px” border_color_all=”#E1E163″]<\/p>\n
TestRail 6.6 \u4ee5\u964d\u3001\u7ba1\u7406\u8005\u3060\u3051\u304c project_id \u30d1\u30e9\u30e1\u30fc\u30bf\u30fc\u306a\u3057\u3067 get_users \u3092\u4f7f\u7528\u3067\u304d\u307e\u3059\u3002\u7ba1\u7406\u8005\u4ee5\u5916\u306e\u30e6\u30fc\u30b6\u30fc\u306f\u3001project_id \u30d1\u30e9\u30e1\u30fc\u30bf\u30fc\u3092\u4f7f\u7528\u3059\u308b\u5fc5\u8981\u304c\u3042\u308a\u307e\u3059\u3002<\/p>\n
[\/et_pb_text]<\/p>\n<\/div>\n
<\/p>\n
\u30d1\u30e9\u30e1\u30fc\u30bf\u30fc<\/h3>\n\n\n\n\n\n
\u540d\u524d<\/th>\n\u30bf\u30a4\u30d7<\/th>\n\u5fc5\u9808<\/th>\n\u8aac\u660e<\/th>\n<\/tr>\n<\/thead>\n
project_id<\/td>\ninteger<\/td>\ntrue<\/td>\n\u30e6\u30fc\u30b6\u30fc\u60c5\u5831\u3092\u53d6\u5f97\u3059\u308b\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u306e ID(\u7ba1\u7406\u8005\u4ee5\u5916\u306e\u5834\u5408\u306b\u5fc5\u9808)(TestRail 6.6 \u4ee5\u964d\u304c\u5fc5\u8981<\/strong>)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
<\/div>\n
\u6ce8\u610f\uff1a<\/strong><\/div>\n