REST Resource: matters
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: Matter
Rappresenta una questione.
Per utilizzare le risorse di Vault, l'account deve disporre dei privilegi di Vault richiesti e dell'accesso alla pratica. Per accedere a una pratica, l'account deve averla creata, averla condivisa con l'account o disporre del privilegio Visualizzazione di tutte le pratiche.
Rappresentazione JSON |
{
"matterId": string,
"name": string,
"description": string,
"state": enum (State ),
"matterPermissions": [
{
object (MatterPermission )
}
],
"matterRegion": enum (MatterRegion )
} |
Campi |
matterId |
string
L'ID richiesta, generato dal server. Lascia vuoto questo campo quando crei una richiesta.
|
name |
string
Il nome della questione.
|
description |
string
Una descrizione facoltativa della questione.
|
state |
enum (State )
Lo stato della questione.
|
matterPermissions[] |
object (MatterPermission )
Elenca gli utenti e le relative autorizzazioni per la richiesta. Al momento non esiste un limite definito dal programmatore per il numero di autorizzazioni che può avere una richiesta.
|
matterRegion |
enum (MatterRegion )
Facoltativo. La regione di dati richiesta per la richiesta.
|
Stato
Enum |
STATE_UNSPECIFIED |
La richiesta non ha uno stato specificato. |
OPEN |
La richiesta è aperta. |
CLOSED |
La questione è chiusa. |
DELETED |
La richiesta viene eliminata. |
MatterPermission
Gli utenti possono essere proprietari o collaboratori di Matter. Ogni richiesta ha un solo proprietario. Tutti gli altri utenti che possono accedere alla richiesta sono collaboratori. Quando un account viene eliminato, le risorse MatterPermission corrispondenti non esistono più.
Rappresentazione JSON |
{
"role": enum (AclRole ),
"accountId": string
} |
Campi |
role |
enum (AclRole )
Il ruolo dell'utente per la richiesta.
|
accountId |
string
L'ID account, come fornito dall'SDK Admin.
|
AclRole
Le possibili autorizzazioni utente per una richiesta, in ordine di aumento delle autorizzazioni.
Enum |
ROLE_UNSPECIFIED |
Nessun ruolo assegnato. |
COLLABORATOR |
Un collaboratore esperto della questione. |
OWNER |
Il proprietario della richiesta. |
MatterRegion
La regione di dati della richiesta.
Enum |
MATTER_REGION_UNSPECIFIED |
La regione non è specificata. Il valore predefinito è QUALSIASI. |
ANY |
Qualsiasi regione. |
US |
Regione degli Stati Uniti. |
EUROPE |
Regione Europa. |
Metodi |
|
Aggiunge un account come collaboratore della richiesta. |
|
Chiude la richiesta specificata. |
|
Conta gli account elaborati dalla query specificata. |
|
Crea una pratica con il nome e la descrizione dati. |
|
Consente di eliminare la richiesta specificata. |
|
Recupera la richiesta specificata. |
|
Elenca le pratiche a cui il richiedente ha accesso. |
|
Rimuove un account come collaboratore della richiesta. |
|
Riapre la richiesta specificata. |
|
Annullare l'eliminazione della richiesta specificata. |
|
Aggiorna la richiesta specificata. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[],[],null,["# REST Resource: matters\n\n- [Resource: Matter](#Matter)\n - [JSON representation](#Matter.SCHEMA_REPRESENTATION)\n- [State](#State)\n- [MatterPermission](#MatterPermission)\n - [JSON representation](#MatterPermission.SCHEMA_REPRESENTATION)\n- [AclRole](#AclRole)\n- [MatterRegion](#MatterRegion)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Matter\n----------------\n\nRepresents a matter.\n\nTo work with Vault resources, the account must have the [required Vault privileges](https://support.google.com/vault/answer/2799699) and access to the matter. To access a matter, the account must have created the matter, have the matter shared with them, or have the **View All Matters** privilege.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"matterId\": string, \"name\": string, \"description\": string, \"state\": enum (/workspace/vault/reference/rest/v1/matters#State), \"matterPermissions\": [ { object (/workspace/vault/reference/rest/v1/matters#MatterPermission) } ], \"matterRegion\": enum (/workspace/vault/reference/rest/v1/matters#MatterRegion) } ``` |\n\n| Fields ||\n|-----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `matterId` | `string` The matter ID, which is generated by the server. Leave blank when creating a matter. |\n| `name` | `string` The name of the matter. |\n| `description` | `string` An optional description for the matter. |\n| `state` | `enum (`[State](/workspace/vault/reference/rest/v1/matters#State)`)` The state of the matter. |\n| `matterPermissions[]` | `object (`[MatterPermission](/workspace/vault/reference/rest/v1/matters#MatterPermission)`)` Lists the users and their permission for the matter. Currently there is no programmer defined limit on the number of permissions a matter can have. |\n| `matterRegion` | `enum (`[MatterRegion](/workspace/vault/reference/rest/v1/matters#MatterRegion)`)` Optional. The requested data region for the matter. |\n\nState\n-----\n\nThe state of a matter.\n\n| Enums ||\n|---------------------|------------------------------------|\n| `STATE_UNSPECIFIED` | The matter has no specified state. |\n| `OPEN` | The matter is open. |\n| `CLOSED` | The matter is closed. |\n| `DELETED` | The matter is deleted. |\n\nMatterPermission\n----------------\n\nUsers can be matter owners or collaborators. Each matter has only one owner. All others users who can access the matter are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------|\n| ``` { \"role\": enum (/workspace/vault/reference/rest/v1/matters#AclRole), \"accountId\": string } ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------|\n| `role` | `enum (`[AclRole](/workspace/vault/reference/rest/v1/matters#AclRole)`)` The user's role for the matter. |\n| `accountId` | `string` The account ID, as provided by the [Admin SDK](https://developers.google.com/admin-sdk/). |\n\nAclRole\n-------\n\nThe possible user permissions for a matter, in order of increasing permissions.\n\n| Enums ||\n|--------------------|-------------------------------|\n| `ROLE_UNSPECIFIED` | No role assigned. |\n| `COLLABORATOR` | A collaborator on the matter. |\n| `OWNER` | The owner of the matter. |\n\nMatterRegion\n------------\n\nThe data region for the matter.\n\n| Enums ||\n|-----------------------------|---------------------------------------------|\n| `MATTER_REGION_UNSPECIFIED` | The region is unspecified. Defaults to ANY. |\n| `ANY` | Any region. |\n| `US` | United States region. |\n| `EUROPE` | Europe region. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------|-------------------------------------------------------|\n| ### [addPermissions](/workspace/vault/reference/rest/v1/matters/addPermissions) | Adds an account as a matter collaborator. |\n| ### [close](/workspace/vault/reference/rest/v1/matters/close) | Closes the specified matter. |\n| ### [count](/workspace/vault/reference/rest/v1/matters/count) | Counts the accounts processed by the specified query. |\n| ### [create](/workspace/vault/reference/rest/v1/matters/create) | Creates a matter with the given name and description. |\n| ### [delete](/workspace/vault/reference/rest/v1/matters/delete) | Deletes the specified matter. |\n| ### [get](/workspace/vault/reference/rest/v1/matters/get) | Gets the specified matter. |\n| ### [list](/workspace/vault/reference/rest/v1/matters/list) | Lists matters the requestor has access to. |\n| ### [removePermissions](/workspace/vault/reference/rest/v1/matters/removePermissions) | Removes an account as a matter collaborator. |\n| ### [reopen](/workspace/vault/reference/rest/v1/matters/reopen) | Reopens the specified matter. |\n| ### [undelete](/workspace/vault/reference/rest/v1/matters/undelete) | Undeletes the specified matter. |\n| ### [update](/workspace/vault/reference/rest/v1/matters/update) | Updates the specified matter. |"]]