Actualiza la lista de usuarios que pertenecen a un grupo.

Solo los administradores pueden usar esta API.

Para obtener más información sobre los administradores, consulte el siguiente artículo:
Tipos de administradores

Parámetro	Valor	Obligatorio	Descripción
code	Cuerda	Sí	El código del Grupo. Debe tener 128 caracteres o menos. No se pueden especificar grupos dinámicos. Para obtener más información sobre los grupos dinámicos, consulte la sección Administración de grupos (roles) del siguiente vínculo: Configuración de grupos (roles)
users	Matriz de cadenas	Sí	Una lista de códigos de usuario (nombres de inicio de sesión) que pertenecen al Grupo. Se pueden especificar hasta 1000 códigos de usuario. Los usuarios que ya pertenezcan al grupo serán eliminados si no se incluyen sus códigos de usuario. Para eliminar todos los usuarios que pertenecen al grupo, especifique una matriz vacía.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

var body = {
  'codes': [
    {
      'code': 'Recruit2023',
      'users': [
        'Krispy', 'Morris'
      ]
    }
  ]
};

kintone.api(kintone.api.url('/v1/group/users.json', true), 'PUT', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

$ curl -X PUT \
  https://{subdomain}.kintone.com/v1/group/users.json \
  -H 'Content-Type: application/json' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -d '{
    'code': 'Recruit2023',
    'users': [
      'Krispy', 'Morris'
    ]
  }'

Se devuelve un objeto JSON vacío.

1

{}

• Los grupos dinámicos no se pueden actualizar.
  Para actualizar los usuarios que pertenecen a los grupos, edite las condiciones de los grupos dinámicos.
  Para obtener más información sobre los grupos dinámicos, consulte la sección Administración de grupos (roles) del siguiente artículo:
  Configuración de grupos (roles)
• No se recomienda ejecutar esta API mientras se realizan las siguientes operaciones en el Administración de usuarios y sistemas página:
  • Actualizaciones de los grupos en el Grupos (o roles) página
    Para obtener más información sobre los grupos (o roles), consulte el siguiente artículo:
    Gestión de grupos (o roles)
  • Importar desde un archivo