REST Resource: matters
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zasób: Matter
Reprezentuje sprawę.
Aby korzystać z zasobów Vault, konto musi mieć wymagane uprawnienia Vault i dostęp do sprawy. Aby uzyskać dostęp do sprawy, konto musi być jej twórcą, sprawa musi zostać udostępniona temu kontu lub konto musi mieć uprawnienie Wyświetlanie wszystkich spraw.
Zapis JSON |
{
"matterId": string,
"name": string,
"description": string,
"state": enum (State ),
"matterPermissions": [
{
object (MatterPermission )
}
],
"matterRegion": enum (MatterRegion )
} |
Pola |
matterId |
string
Identyfikator sprawy wygenerowany przez serwer. Pozostaw puste podczas tworzenia sprawy.
|
name |
string
Nazwa sprawy.
|
description |
string
Opcjonalny opis sprawy.
|
state |
enum (State )
Stan sprawy.
|
matterPermissions[] |
object (MatterPermission )
Wyświetla listę użytkowników i ich uprawnienia do sprawy. Obecnie nie ma żadnego limitu zdefiniowanego przez programistę dotyczącego liczby uprawnień, które może mieć sprawa.
|
matterRegion |
enum (MatterRegion )
Opcjonalnie: Żądany region danych dotyczący sprawy.
|
Stan
Wartości w polu enum |
STATE_UNSPECIFIED |
Sprawa nie ma określonego stanu. |
OPEN |
Sprawa jest otwarta. |
CLOSED |
Sprawa została zamknięta. |
DELETED |
Sprawa została usunięta. |
MatterPermission
Użytkownicy mogą być właścicielami sprawy lub współpracownikami. Każda sprawa ma tylko jednego właściciela. Wszyscy inni użytkownicy, którzy mają dostęp do sprawy, są współpracownikami. Gdy konto zostanie usunięte, odpowiednie zasoby MatterPermission przestaną istnieć.
Zapis JSON |
{
"role": enum (AclRole ),
"accountId": string
} |
AclRole
Możliwe uprawnienia użytkownika w sprawie, w kolejności od najmniejszych do największych.
Wartości w polu enum |
ROLE_UNSPECIFIED |
Nie przypisano roli. |
COLLABORATOR |
Współpracownik w tej sprawie. |
OWNER |
Właściciel sprawy. |
MatterRegion
Region danych dotyczący sprawy.
Wartości w polu enum |
MATTER_REGION_UNSPECIFIED |
Region nie został określony. Wartość domyślna to dowolna. |
ANY |
dowolny region, |
US |
Region Stany Zjednoczone. |
EUROPE |
Europe. |
Metody |
|
Dodaje konto jako współpracownika sprawy. |
|
Zamyka wskazaną sprawę. |
|
Liczba kont przetworzonych przez określone zapytanie. |
|
Tworzy sprawę o danej nazwie i opisie. |
|
Usunięcie określonej sprawy. |
|
Pobiera podany temat. |
|
Wyświetla listę spraw, do których użytkownik ma dostęp. |
|
Usuwanie konta jako współpracownika sprawy. |
|
Ponownie otwiera wybraną sprawę. |
|
przywraca określone sprawy do stanu sprzed usunięcia. |
|
Aktualizuje wybraną sprawę. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]