Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

usermacro.updateglobal

Описание

object usermacro.updateglobal(объект/массив globalMacros)

Этот метод позволяет обновлять существующие глобальные макросы.

Этот метод доступен только пользователю с типом доступа Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(объект/массив) Свойства глобального макроса, которые будут обновлены.

Свойство globalmacroid должно быть указано по каждому глобальному макросу, все остальные свойства опциональны. Будут обновлены только переданные свойства, все остальные останутся неизменными.

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

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

Примеры

Изменение значения глобального макроса

Изменение значения глобального макроса на "public".

Запрос:

{
           "jsonrpc": "2.0",
           "method": "usermacro.updateglobal",
           "params": {
               "globalmacroid": "1",
               "value": "public"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "globalmacroids": [
                   "1"
               ]
           },
           "id": 1
       }

Источник

CUserMacro::updateGlobal() в ui/include/classes/api/services/CUserMacro.php.