Actualizar usuarios del grupo

Actualiza la lista de usuarios que pertenecen a un grupo.

MétodoPUT
URLhttps://{subdomain}.kintone.com/v1/group/users.json
Autenticación Autenticación de contraseña, Autenticación de sesión
Content-Typeapplication/json

Contenido

Permisos

Solo los administradores pueden usar esta API.

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

Parámetros de solicitud

Parámetro Valor Obligatorio Descripción
code Cuerda 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) (External link)
users Matriz de cadenas 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.

Solicitud de muestra

 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);
});

Muestra de curl

 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'
    ]
  }'

Parámetros de respuesta

Se devuelve un objeto JSON vacío.

Ejemplo de respuesta

1
{}

Limitaciones

  • 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) (External link)
  • 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) (External link)
    • Importar desde un archivo