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, compartido 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)

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 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 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 para el asunto.
accountId

string

El ID de la cuenta, tal 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 en el asunto.
OWNER El propietario del asunto.

Región de Matter

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 se procesaron según 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 asuntos a los que el solicitante tiene acceso.

removePermissions

 Quitar una cuenta como colaborador del asunto

reopen

 Vuelve a abrir el asunto especificado.

undelete

 Recupera el asunto especificado.

update

 Actualiza el asunto especificado.