Actualizar a los miembros invitados

Actualiza los miembros invitados de un espacio.

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

Contenido

Permisos

  • Solo el administrador del espacio de invitado puede utilizar esta API.

Parámetros de solicitud

Parámetro Valor Obligatorio Descripción
id Entero o cadena El ID del espacio de invitado.
guests Arreglo Una lista de direcciones de correo electrónico de usuarios invitados.

Los usuarios invitados primero deben agregarse como usuarios invitados de Kintone antes de que puedan afiliarse a Spaces. Para ello, utilice la API Add Guests. Para obtener más información, consulte el siguiente documento:
Agregar invitados
Los usuarios que no son usuarios invitados o que son usuarios inactivos o eliminados no se pueden agregar a la lista.

Solicitud de muestra

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
var body = {
  'id': 1001,
  'guests': [
    'guest1@example.com',
    'guest2@example.com',
    'guest3@example.com'
  ]
};

kintone.api(kintone.api.url('/k/guest/{guestspaceId}/v1/space/guests.json', false), '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
var body = {
  'id': 1001,
  'guests': [
    'guest1@example.com',
    'guest2@example.com',
    'guest3@example.com'
  ],
  // 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/guest/{guestspaceId}/v1/space/guests.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

  • Si la función Espacio o Espacio de invitado está desactivada, se devolverá un error.
  • Los usuarios invitados primero deben agregarse como usuarios invitados de Kintone antes de que puedan afiliarse a Spaces. Para ello, utilice la siguiente API:
    Agregar invitados