Documentos de API

Agregar grupos

Agrega grupos a un entorno de Kintone.

MétodoPOST
URLhttps://{subdomain}.kintone.com/v1/groups.json
Autenticación Autenticación mediante token API , Autenticación mediante contraseña , Autenticación mediante 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 Tipo Obligatorio Descripción
groups Matriz de objetos Sí Una matriz de groups objetos, que contienen los datos de los grupos que se van a añadir.
Hasta 100 groups Se pueden especificar objetos.
groups[].code Cuerda Sí El código de grupo.
El límite máximo es de 128 caracteres.
No se permiten valores que consten solo de espacios en blanco o nulos.
groups[].name Cuerda Sí El nombre del Grupo.
El límite máximo es de 128 caracteres.
groups[].type Cuerda Sí El tipo de Grupo.
Se debe especificar "static" o "dynamic".
groups[].description Cuerda Opcional La descripción del Grupo.
El límite máximo es de 1000 caracteres.

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
20
21
22
23
24

var body = {
  'groups': [
    {
      'code': '1',
      'name': 'Officer',
      'type': 'dynamic',
      'description': ''
    },
    {
      'code': 'general_manager',
      'name': 'General Manager',
      'type': 'static',
      'description': 'A group with all the general managers.'
    }
  ]
};

kintone.api(kintone.api.url('/v1/groups.json', true), 'POST', 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
11
12
13
14
15
16
17
18
19
20

$ curl -X POST \
  https://{subdomain}.kintone.com/v1/groups.json \
  -H 'Content-Type: application/json' \
  -H 'X-Cybozu-Authorization: a2ludG9uZTpkZXZlbG9wZXI=' \
  -d '{"groups":
  [
    {
      "code": "1",
      "name": "Officer",
      "type": "dynamic",
      "description": ""
    },
    {
      "code": "general_manager",
      "name": "General Manager",
      "type": "static",
      "description": "A group with all the general managers."
    }
  ]
}'

Parámetros de respuesta

Se devolverá un objeto JSON vacío.

Ejemplo de respuesta

1

{}

Limitaciones

  • 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