[comment]: # translation:outdated

[comment]: # ({97b0e55a-97b0e55a})
# 更新

[comment]: # ({/97b0e55a-97b0e55a})

[comment]: # ({6519686e-4cbfe789})
### 描述

`object mediatype.update(object/array mediaTypes)`

此方法允许更新现有的媒介类型。

::: noteclassic
此方法仅适用于 *超级管理员* 用户类型。
可以在用户角色设置中撤销调用该方法的权限。更多信息请查看 [用户角色](/manual/web_interface/frontend_sections/administration/user_roles)。
:::

[comment]: # ({/6519686e-4cbfe789})

[comment]: # ({32a8e1c7-7db8f4bd})
### 参数

`(object/array)` 需要被更新的媒介类型属性。

必须为每种媒介类型定义 `mediatypeid` 属性，其他所有属性都是可选的。只有传递的属性会被更新，其他所有的都将保持不变。

除了[标准媒介类型属性](object#媒介类型)外，此方法还接受以下参数。

|参数|[类型](/manual/api/reference_commentary#data_types)|描述|
|--|--|------|
|parameters|array|[Script](object#script_parameters) 或 [webhook](object#webhook_parameters) 参数替换当前参数。|
|message\_templates|array|[消息模板](object#message_template) 替换当前的消息模板。|

[comment]: # ({/32a8e1c7-7db8f4bd})

[comment]: # ({665d000d-665d000d})
### 返回值

`(object)` 返回包含`mediatypeids`属性下所更新IDs的对象。

[comment]: # ({/665d000d-665d000d})

[comment]: # ({b41637d2-b41637d2})
### 示例

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

[comment]: # ({740b73a6-8d3ba0cc})
#### 启用媒介类型

启用媒体类型，即将其状态设置为"0"。

[请求](/manual/api#performing-requests)：

```json
{
    "jsonrpc": "2.0",
    "method": "mediatype.update",
    "params": {
        "mediatypeid": "6",
        "status": "0"
    },
    "id": 1
}
```

响应：

```json
{
    "jsonrpc": "2.0",
    "result": {
        "mediatypeids": [
            "6"
        ]
    },
    "id": 1
}
```

[comment]: # ({/740b73a6-8d3ba0cc})

[comment]: # ({b9cdc31e-b9cdc31e})
### 来源

*ui/include/classes/api/services/CMediaType.php* 中的 CMediaType::update()。

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