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 acceso al asunto. Para acceder a un asunto, la cuenta debe haberlo creado, compartirlo con ella o tener el privilegio Ver todos los asuntos.

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

string

El ID del asunto, que genera el servidor. Deja este campo en blanco cuando crees un asunto.

name

string

El nombre del asunto.

description

string

Una descripción opcional para el asunto.

state

enum (State)

Es el estado del asunto.

matterPermissions[]

object (MatterPermission)

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

matter_region

enum (MatterRegion)

La región de datos del asunto.

Estado

El estado de un asunto.

Enumeraciones
STATE_UNSPECIFIED El asunto no tiene un estado especificado.
OPEN El asunto está abierto.
CLOSED El asunto está cerrado.
DELETED Se borrará el asunto.

MatterPermission

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

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

enum (AclRole)

El rol del usuario en el asunto

accountId

string

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

AclRole

Los posibles permisos de los usuarios de un asunto, en orden de aumento de los permisos.

Enumeraciones
ROLE_UNSPECIFIED No se asignaron funciones.
COLLABORATOR Un colaborador sobre el asunto.
OWNER Es el propietario del asunto.

Región de Matter

Es la región de datos de un asunto.

Enumeraciones
MATTER_REGION_UNSPECIFIED El asunto no tiene una región de datos especificada.
ANY El asunto no tiene una región de datos especificada.
US El asunto tiene una región de datos de EE.UU.
EU El asunto tiene una región de datos de la UE.

Métodos

addPermissions

Agrega una cuenta como colaborador del asunto.

close

Cierra el asunto especificado.

count

Cuenta las cuentas que procesa la consulta especificada.

create

Crea un asunto con el nombre y la descripción que se indican.

delete

Borra el asunto especificado.

get

Obtiene el asunto especificado.

list

Las listas son asuntos a los que el solicitante tiene acceso.

removePermissions

Quita una cuenta como colaborador de un asunto.

reopen

Vuelve a abrir el asunto especificado.

undelete

Recupera el asunto especificado.

update

Actualiza el asunto especificado.