[comment]: # translation:outdated

[comment]: # ({a16741b3-a16741b3})
# usermacro.updateglobal

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

[comment]: # ({19b16b0b-19b16b0b})
### Description

`object usermacro.updateglobal(object/array globalMacros)`

Cette méthode permet de mettre à jour les macros globales existantes.

::: noteclassic
Cette méthode est seulement disponible pour les utilisateurs du type *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations.
:::

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

[comment]: # ({be7c969e-be7c969e})
### Paramètres

`(object/array)` [Propriétés des macros globales](/manual/api/reference/usermacro/object#global_macro)) à mettre à jour.

La propriété `globalmacroid` doit être définie pour chaque macro globale. Toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.

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

[comment]: # ({9c6d43ad-9c6d43ad})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des macros globales mises à jour sous la propriété `globalmacroids`.

[comment]: # ({/9c6d43ad-9c6d43ad})

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

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

[comment]: # ({bd208b05-bd208b05})
#### Modification de la valeur d'une macro globale

Modifier la valeur d'une macro globale à "public".

Requête :

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

Réponse :

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

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

[comment]: # ({85ca09bc-85ca09bc})
### Source

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

[comment]: # ({/85ca09bc-85ca09bc})