Actualizar grupos de usuarios

Actualiza la información de los grupos a los que pertenece un usuario.

MétodoPUT
URLhttps://{subdomain}.kintone.com/v1/user/groups.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 nombre de inicio de sesión del usuario.
Debe tener 128 caracteres o menos. No se permiten cadenas vacías ni caracteres que consten solo de espacios en blanco.
groups Arreglo Matriz de códigos de grupo a la que pertenece el usuario.
Se pueden especificar hasta 1000 códigos de grupo.
Si un usuario pertenece a un grupo, pero el grupo no se especifica en la solicitud, el usuario se elimina del grupo.
Si la matriz está vacía, el usuario se elimina de todos los grupos.
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)

Solicitud de muestra

Actualice los grupos a los que pertenece el usuario1 al grupo1 y al grupo2.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
var body = {
  'code': 'user1',
  'groups': [
    'group1', 'group2'
  ]
};

kintone.api(kintone.api.url('/v1/user/groups.json', true), 'PUT', body, function(resp) {
  'use strict';
  // success
  console.log(resp);
}, function(error) {
  'use strict';
  // error
  console.log(error);
});

Muestra de curl

Actualice los grupos a los que pertenece el usuario1 al grupo1 y al grupo2.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
$ curl -X PUT \
  https://{subdomain}.kintone.com/v1/user/groups.json \
  -H 'Content-Type: application/json' \
  -H 'X-Cybozu-Authorization: a2ludG9uZTpkZXZlbG9wZXI=' \
  -d '{
    'code': 'user1',
    'groups': [
      'group1', 'group2'
    ]
  }'

Parámetros de respuesta

Se devuelve un objeto JSON vacío.

Ejemplo de respuesta

1
{}

Limitaciones

  • No se recomienda ejecutar esta API mientras se realizan las siguientes operaciones en el Administración de usuarios y sistemas página:
    • Actualizaciones para los usuarios en el Departamentos y Usuarios página
      Para obtener más información sobre Departamentos y usuarios, consulte el siguiente artículo:
      Gestión de usuarios (External link)
    • Importar desde un archivo