Grupos de actualización

Documentos de API

Grupos de actualización

Actualizar los grupos a un entorno Kintone.
Se pueden actualizar hasta 100 grupos a la vez.

Método	PUT
URL	https://{subdomain}.kintone.com/v1/groups.json
Autenticación	Autenticación de token de API , Autenticación de contraseña , Autenticación de sesión
Content-Type	application/json

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

Parámetros de solicitud

Parámetro	Valor	Obligatorio	Descripción
groups	Matriz de objetos	Sí	Una matriz de grupos objetos, que contienen datos de los Grupos a actualizar.
groups[].code	Cuerda	Sí	El código del Grupo se actualizará. El límite máximo es de 128 caracteres. No se permiten cadenas vacías ni caracteres que consten solo de espacios en blanco.
groups[].name	Cuerda	Sí	El nombre del Grupo. El límite máximo es de 128 caracteres. No se permiten cadenas vacías ni caracteres que consten solo de espacios en blanco. Si se omite o `null` se especifica, el valor no se actualizará.
groups[].description	Cuerda	Opcional	La descripción del Grupo. El límite máximo es de 1000 caracteres. Si se omite o `null` se especifica, el valor no se actualizará.

Solicitud de muestra

JavaScript using kintone.api()

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


var body = {
  'groups': [
    {
      'code': 'group_code1',
      'name': 'group_name1',
      'description': 'group_description1'
    }
  ]
};

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

Muestra de curl

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


$ curl -X PUT \
  https://{subdomain}.kintone.com/v1/groups.json \
  -H 'Content-Type: application/json' \
  -H 'X-Cybozu-Authorization: a2ludG9uZTpkZXZlbG9wZXI=' \
  -d '{
    'groups': [
      {
        'code': 'target_group_code',
        'name': 'updated_group_name',
        'description': 'updated_group_description'
      }
    ]
  }'

Parámetros de respuesta

Se devolverá un objeto JSON vacío.

Ejemplo de respuesta

1

{}

Limitaciones

Los códigos del grupo no pueden cambiarse.
No se recomienda ejecutar esta API mientras se realizan las siguientes operaciones en el Usuarios y Administración del Sistema 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