# user.updatemedia

### Описание

`объект user.updatemedia(объект параметры)`

Этот метод позволяет обновлять оповещения пользователя у нескольких
пользователей.

::: notewarning
Этот метод является устаревшим и в будущих версиях
будет удален. Пожалуйста, используйте [user.update](update) вместо этого
метода.
:::

### Параметры

`(объект)` Параметры, которые задают обновляемые оповещения
пользователей и самих пользователей.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|**medias**<br>(требуется)|объект/массив|Оповещения пользователя, которые заменят существующие оповещения пользователя. Если у оповещения пользователя задан параметр `mediaid`, оно будет обновлено. В противном случае будет создано новое оповещение пользователя.|
|**users**<br>(требуется)|объект/массив|Обновляемые пользователи.<br><br>У пользователей должно быть задано свойство `userid`.|

### Возвращаемые значения

`(объект)` Возвращает объект, который содержит ID обновленных
пользователей под свойством `userids`.

### Примеры

#### Замена оповещений пользователя у нескольких пользователей

Замена всех оповещений пользователя, которые использовались двумя
пользователями, на общее e-mail оповещение пользователей. Это оповещение
пользователя должно отправлять оповещения о всех проблемах в любое
время.

Запрос:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "user.updatemedia",
    "params": {
        "users": [
            {
                "userid": "1"
            },
            {
                "userid": "2"
            }
        ],
        "medias": {
            "mediatypeid": "1",
            "sendto": "support@company.com",
            "active": 0,
            "severity": 63,
            "period": "1-7,00:00-24:00"
        }
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Ответ:

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "userids": [
            "1",
            "2"
        ]
    },
    "id": 1
}
```

### Смотрите также

-   [user.addmedia](addmedia)
-   [user.deletemedia](deletemedia)
-   [user.updatemedia](updatemedia)
-   [Оповещение
    пользователя](/ru/manual/api/reference/usermedia/object#оповещение_пользователя)
-   [Пользователь](object#пользователь)

### Исходный код

CUser::updateMedia() в
*frontends/php/include/classes/api/services/CUser.php*.