Actualizar los servicios de usuario

Documentos de API

Actualizar los servicios de usuario

Actualiza los servicios que los usuarios pueden utilizar en un entorno Kintone.

Método	PUT
URL	https://{subdomain}.kintone.com/v1/users/services.json
Autenticación	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

En la solicitud se debe especificar una matriz "users" que consiste en un objeto formado por las siguientes propiedades. Se pueden actualizar servicios de hasta 100 usuarios.

Parámetro	Valor	Obligatorio	Descripción
code	Cuerda	Sí	El código de usuario (nombre de inicio de sesión). El límite máximo es de 100 caracteres. No se permiten valores que consten solo de espacios en blanco o nulos.
services	Arreglo	Sí	El Código de Servicio. Indique que ya sea `kintone` o una matriz vacía.

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
25
26
27


var body = {
  'users': [
    {
      'code': 'user1',
      'services': [
        'kintone'
      ]
    },
    {
      'code': 'user2',
      'services': [
        'kintone'
      ]
    },
    {
      'code': 'user3',
      'services': []
    }
  ]
};
kintone.api(kintone.api.url('/v1/users/services.json', true), 'PUT', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

XMLHttpRequest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38


var body = {
  'users': [
    {
      'code': 'user1',
      'services': [
        'kintone'
      ]
    },
    {
      'code': 'user2',
      'services': [
        'kintone'
      ]
    },
    {
      'code': 'user3',
      'services': []
    }
  ],
  // CSRF TOKEN: Needs to be set when using API (POST, PUT, DELETE) from kintone
  '__REQUEST_TOKEN__': kintone.getRequestToken()
};

var url = 'https://{subdomain}.kintone.com/v1/users/services.json';
var xhr = new XMLHttpRequest();
xhr.open('PUT', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.onload = function() {
  if (xhr.status === 200) {
    // success
    console.log(JSON.parse(xhr.responseText));
  } else {
    // error
    console.log(JSON.parse(xhr.responseText));
  }
};
xhr.send(JSON.stringify(body));

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 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
- Importar desde un archivo