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 contraseña , Autenticación de sesión
Content-Type application/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
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) (External link)
    • Importar desde un archivo