REST Resource: matters

Recurso: Matter

Representa un asunto.

Para trabajar con los recursos de Vault, la cuenta debe tener los privilegios de Vault necesarios y el acceso al asunto. Para acceder a un asunto, la cuenta debe haber creado el asunto, tenerlo compartido con él o tener el privilegio Ver todos los asuntos.

Representación JSON 
{
  "matterId": string,
  "name": string,
  "description": string,
  "state": enum (State),
  "matterPermissions": [
    {
      object (MatterPermission)
    }
  ]
}
Campos
matterId

string

El ID del asunto, que genera el servidor. Dejar en blanco cuando se crea un asunto
name

string

El nombre del asunto.
description

string

Una descripción opcional para el asunto.
state

enum (State)

El estado de la materia.
matterPermissions[]

object (MatterPermission)

Enumera los usuarios y sus permisos para el asunto. Actualmente, el programador no establece un límite definido para la cantidad de permisos que puede tener un asunto.

Estado

El estado de un asunto.

Enumeradores
STATE_UNSPECIFIED El asunto no tiene un estado especificado.
OPEN El asunto está abierto.
CLOSED El asunto está cerrado.
DELETED Se borró el asunto.

MatterPermission

Los usuarios pueden ser propietarios o colaboradores de asuntos. Cada asunto tiene solo un propietario. Todos los demás usuarios que pueden acceder al asunto son colaboradores. Cuando una cuenta se borra definitivamente, sus recursos MatterPermission correspondientes dejan de existir.

Representación JSON 
{
  "role": enum (AclRole),
  "accountId": string
}
Campos
role

enum (AclRole)

Es el rol del usuario en el asunto.
accountId

string

El ID de la cuenta, tal como lo proporciona el SDK de Admin.

AclRole

Los posibles permisos del usuario para un asunto, en orden de aumento de los permisos.

Enumeradores
ROLE_UNSPECIFIED No se asignaron funciones.
COLLABORATOR Un colaborador en el asunto.
OWNER El propietario del asunto.

Métodos

addPermissions

 Agrega una cuenta como colaborador del asunto.

close

 Cierra el asunto especificado.

count

 Cuenta las cuentas procesadas por la consulta especificada.

create

 Crea un asunto con el nombre y la descripción especificados.

delete

 Borra el asunto especificado.

get

 Obtiene el asunto especificado.

list

 Las listas son importantes para las que el solicitante tiene acceso.

removePermissions

 Quita una cuenta como colaborador del asunto.

reopen

 Vuelve a abrir el asunto especificado.

undelete

 Recupera el asunto especificado.

update

 Actualiza el asunto especificado.