[comment]: # ({c40e8cd1-c40e8cd1})
# קבוצת משתמשים.צור

[comment]: # ({/c40e8cd1-c40e8cd1})

[comment]: # ({ed675eb1-c74b5711})
### תיאור

`object usergroup.create(object/array userGroups)`

שיטה זו מאפשרת ליצור קבוצות משתמשים חדשות.

::: noteclassic
שיטה זו זמינה רק לסוג משתמש *סופר אדמין*.
ניתן לבטל הרשאות להתקשר למתודה בהגדרות תפקידי המשתמש. לִרְאוֹת
[מִשׁתַמֵשׁ
תפקידים](/manual/web_interface/frontend_sections/administration/user_roles)
למידע נוסף.
:::

[comment]: # ({/ed675eb1-c74b5711})

[comment]: # ({e4a18364-3b20a75b})
### פרמטרים

`(אובייקט/מערך)` קבוצות משתמשים ליצירה.

בנוסף ל[מאפייני קבוצת המשתמשים הסטנדרטיים](object#user_group),
השיטה מקבלת את הפרמטרים הבאים.

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|rights|object/array|[הרשאות](/manual/api/reference/usergroup/object#permission) להקצאה לקבוצה|
|tag\_filters|מערך|[הרשאות מבוססות תגים](/manual/api/reference/usergroup/object#tag_based_permission) להקצאה לקבוצה|
|users|object/array|[Users](/manual/api/reference/user/create) כדי להוסיף לקבוצת המשתמשים.<br><br>למשתמש חייב להיות מוגדר המאפיין 'userid'.|

[comment]: # ({/e4a18364-3b20a75b})

[comment]: # ({19e4f0cc-19e4f0cc})
### החזר ערכים

`(אובייקט)` מחזירה אובייקט המכיל את המזהים של המשתמש שנוצר
קבוצות תחת המאפיין 'usrgrpids'. סדר התעודות המוחזרות
תואם את הסדר של קבוצות המשתמשים שעברו.

[comment]: # ({/19e4f0cc-19e4f0cc})

[comment]: # ({b41637d2-b41637d2})
### דוגמאות

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({21f27ee7-61abd39a})
#### יצירת קבוצת משתמשים

צור קבוצת משתמשים, שמונעת גישה לקבוצה המארחת "2", והוסף א
משתמש אליו.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "usergroup.create",
     "params": {
         "name": "מנהלי תפעול",
         "זכויות": {
             "רשות": 0,
             "id": "2"
         },
         "משתמשים": [
             {"userid": "12"}
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "usrgrpids": [
             "20"
         ]
     },
     "מזהה": 1
}
```

[comment]: # ({/21f27ee7-61abd39a})

[comment]: # ({d5c7ed4f-d5c7ed4f})
### מידע נוסף

-   [הרשאה](object#permission)

[comment]: # ({/d5c7ed4f-d5c7ed4f})

[comment]: # ({2d7f8c71-2d7f8c71})
### מקור

CUserGroup::create()‎ בתוך
*ui/include/classes/api/services/CUserGroup.php*.

[comment]: # ({/2d7f8c71-2d7f8c71})