Actualizar la configuración general de notificaciones
Actualiza la configuración general de notificaciones de la aplicación. Para obtener información sobre las notificaciones, consulte el siguiente artículo:
Notificaciones generales
Esta API actualiza la configuración previa a la puesta en marcha.
Después de usar esta API, use la siguiente API para implementar la configuración en la aplicación activa:
Implementar la configuración de la aplicación
Método | PUT |
---|---|
URL | https://{subdomain}.kintone.com/k/v1/preview/app/notifications/general.json |
URL (espacio de invitado) | https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/preview/app/notifications/general.json |
Autenticación | Autenticación de contraseña, Autenticación de token de API, Autenticación de sesión |
Content-Type | application/json |
Contenido
Permisos
- Se necesitan permisos de administración de aplicaciones.
- A la entidad se le debe conceder el permiso de visualización de registros para que la entidad reciba la notificación.
Parámetros de solicitud
Parámetro | Valor | Obligatorio | Descripción |
---|---|---|---|
app | Entero o cadena | Sí | El identificador de la aplicación. |
notifications | Arreglo | Matriz de objetos que consta de las opciones "Destinatarios y condiciones". Si se envía una matriz vacía, se eliminarán todos los destinatarios. Si se ignora este parámetro, no se realizarán cambios en las opciones de "Destinatarios y condiciones". |
|
notifications[].entity | Objeto | Condicional | Objeto que contiene datos de la entidad en la que está configurada la configuración general de notificación. Obligatorio al especificar el parámetro notifications parámetro. |
notifications[].entity.type | Cuerda | Condicional | El tipo de entidad en la que está configurada la configuración de notificación general.
|
notifications[].entity.code | Cuerda | Condicional | El código de la entidad en la que está configurada la configuración de notificación general. Especifique el código de campo si el notifications[].entity.type se especifica como FIELD_ENTITY. En el caso de los usuarios invitados, agregue guest/ antes del nombre de inicio de sesión. Obligatorio al especificar el parámetro entity parámetro. |
notifications[].includeSubs | Booleano o cadena | La configuración "Incluir departamentos afiliados" del Departamento. Este parámetro está disponible si notifications[].entity.type se especifica en ORGANIZATION o FIELD_ENTITY.
|
|
notifications[].recordAdded | Booleano o cadena | Opción para notificar a la entidad cuando se agrega un registro.
|
|
notifications[].recordEdited | Booleano o cadena | Opción para notificar a la entidad cuando se edita un registro.
|
|
notifications[].commentAdded | Booleano o cadena | Opción para notificar a la entidad cuando se publica un comentario.
|
|
notifications[].statusChanged | Booleano o cadena | Opción para notificar a la entidad cuando se cambia un estado.
|
|
notifications[].fileImported | Booleano o cadena | Opción para notificar a la entidad cuando se importa un archivo.
|
|
notifyToCommenter | Booleano o cadena | Opción para notificar a todos los comentaristas de un registro cuando se publica un comentario en ese registro. Esto refleja la casilla de verificación "Enviar notificaciones de comentarios actualizadas a todos los comentaristas".
|
|
revision | Entero o cadena | Especifique el número de revisión de la configuración que se implementará. Se producirá un error en la solicitud si el número de revisión no es la última revisión. La revisión no se comprobará si se ignora este parámetro o se especifica -1. |
Solicitud de muestra
|
|
XMLHttpRequest
|
|
Parámetros de respuesta
Parámetro | Tipo | Descripción |
---|---|---|
revision | Cuerda | El número de revisión de la configuración de la aplicación. |
Ejemplo de respuesta
|
|