Espacio de actualización

Documentos de API

Espacio de actualización

Actualiza la configuración de un espacio.

Método	PUT
URL	https://{subdomain}.kintone.com/k/v1/space.json
URL (espacio de invitado)	https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/space.json
Autenticación	Autenticación de contraseña, Autenticación de sesión
Content-Type	application/json

Permisos

Solo los administradores de espacio pueden utilizar esta API.

Parámetros de solicitud

Si se omiten los parámetros en la solicitud, las propiedades relacionadas no se actualizarán.

Parámetro	Valor	Obligatorio	Descripción
id	Entero o cadena	Sí	El ID del espacio.
name	Cuerda		El nuevo nombre del Espacio.
isPrivate	Booleano		El Privado configuración del espacio. `true`: El espacio es privado. `false`: El Espacio no es privado.
fixedMember	Booleano		Las opciones establecidas para el Impedir que los usuarios se unan o abandonen el espacio y sigan o dejen de seguir los hilos ajuste. `true`: Los usuarios no pueden unirse/salir del espacio ni seguir/dejar de seguir los hilos. `false`: Los usuarios pueden unirse/salir del espacio y seguir/dejar de seguir los hilos.
useMultiThread	Booleano		El Habilitación de varios subprocesos ajuste. `true`: El espacio es un espacio multiproceso. `false`: El espacio es un espacio de un solo subproceso.
showAnnouncement	Booleano		El estado de visualización de la pantalla Anuncio widget. `true`: El Anuncio widget. `false`: El Anuncio widget no se muestra.
showThreadList	Booleano		El estado de visualización de la pantalla Hilos widget. `true`: El Hilos widget. `false`: El Hilos widget no se muestra.
showAppList	Booleano		El estado de visualización de la pantalla Aplicaciones widget. `true`: El Aplicaciones widget. `false`: El Aplicaciones widget no se muestra.
showMemberList	Booleano		El estado de visualización de la pantalla Gente widget. `true`: El Gente widget. `false`: El Gente widget no se muestra.
showRelatedLinkList	Booleano		El estado de visualización de la pantalla Aplicaciones y espacios relacionados widget. `true`: El Aplicaciones y espacios relacionados widget. `false`: El Aplicaciones y espacios relacionados widget no se muestra.
permissions	Objeto		Objeto que contiene información sobre la configuración de permisos del espacio.
permissions.createApp	Cuerda		La opción establecida para el Permitir que solo los administradores de espacio creen aplicaciones ajuste `EVERYONE`: todos los usuarios pueden crear aplicaciones. `ADMIN`: solo los administradores pueden crear aplicaciones.

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


var body = {
  'id': 1001,
  'name': 'Space Name',
  'isPrivate': true,
  'fixedMember': true,
  'useMultiThread': true,
  'showAnnouncement': true,
  'showThreadList': true,
  'showAppList': true,
  'showMemberList': true,
  'showRelatedLinkList': true,
  'permissions': {
    'createApp': 'EVERYONE'
  }
};

kintone.api(kintone.api.url('/k/v1/space.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


var body = {
  'id': 1001,
  'name': 'Space Name',
  'isPrivate': true,
  'fixedMember': true,
  'useMultiThread': true,
  'showAnnouncement': true,
  'showThreadList': true,
  'showAppList': true,
  'showMemberList': true,
  'showRelatedLinkList': true,
  'permissions': {
    'createApp': 'EVERYONE'
  },
  // CSRF TOKEN: used for all APIs that have an HTTP method of POST, PUT and DELETE on Kintone.
  '__REQUEST_TOKEN__': kintone.getRequestToken()
};

var url = 'https://{subdomain}.kintone.com/k/v1/space.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

{}