REST Resource: matters
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: Matter
문제를 나타냅니다.
Vault 리소스를 사용하려면 계정에 필요한 Vault 권한이 있고 해당 사안에 대한 액세스 권한이 있어야 합니다. 법적 사안에 액세스하려면 해당 계정이 법적 사안을 만들었거나, 법적 사안이 해당 계정과 공유되었거나, 모든 법적 사안 보기 권한이 있어야 합니다.
JSON 표현 |
{
"matterId": string,
"name": string,
"description": string,
"state": enum (State ),
"matterPermissions": [
{
object (MatterPermission )
}
],
"matterRegion": enum (MatterRegion )
} |
필드 |
matterId |
string
서버에서 생성하는 문제 ID입니다. 법적 사안을 만들 때는 이 입력란을 비워 둡니다.
|
name |
string
문제의 이름입니다.
|
description |
string
문제에 대한 설명(선택사항)입니다.
|
state |
enum (State )
사안의 상태입니다.
|
matterPermissions[] |
object (MatterPermission )
문제에 대한 사용자 및 권한을 나열합니다. 현재 문제에 적용할 수 있는 권한 수에 프로그래머가 정의한 제한은 없습니다.
|
matterRegion |
enum (MatterRegion )
선택사항입니다. 케이스에 대해 요청된 데이터 리전입니다.
|
주
열거형 |
STATE_UNSPECIFIED |
지정된 상태가 없는 문제입니다. |
OPEN |
해당 사안은 진행 중입니다. |
CLOSED |
이 문제가 종료되었습니다. |
DELETED |
해당 사안이 삭제됩니다. |
MatterPermission
사용자는 케이스 소유자 또는 공동작업자일 수 있습니다. 각 문제에는 소유자가 한 명만 있습니다. 이 문제에 액세스할 수 있는 다른 모든 사용자는 공동작업자입니다. 계정이 삭제되면 해당하는 MatterPermission 리소스가 더 이상 존재하지 않습니다.
JSON 표현 |
{
"role": enum (AclRole ),
"accountId": string
} |
필드 |
role |
enum (AclRole )
이 문제와 관련된 사용자의 역할입니다.
|
accountId |
string
Admin SDK에서 제공한 계정 ID입니다.
|
AclRole
문제에 대해 가능한 사용자 권한(권한이 증가하는 순서)
열거형 |
ROLE_UNSPECIFIED |
할당된 역할이 없습니다. |
COLLABORATOR |
이 문제와 관련된 공동작업자 |
OWNER |
사안의 소유자입니다. |
MatterRegion
열거형 |
MATTER_REGION_UNSPECIFIED |
지역이 지정되지 않았습니다. 기본값은 ANY입니다. |
ANY |
모든 지역 |
US |
미국 리전 |
EUROPE |
유럽 지역 |
메서드 |
|
계정을 케이스 공동작업자로 추가합니다. |
|
지정된 사안을 종료합니다. |
|
지정된 쿼리로 처리된 계정의 수를 집계합니다. |
|
지정한 이름과 설명을 사용하여 법적 사안을 만듭니다. |
|
지정된 사안을 삭제합니다. |
|
지정된 사안을 가져옵니다. |
|
요청자가 액세스할 수 있는 법적 사안을 표시합니다. |
|
계정을 케이스 공동작업자에서 삭제합니다. |
|
지정된 케이스를 다시 엽니다. |
|
지정된 사안의 삭제를 취소합니다. |
|
지정된 사안을 업데이트합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 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. |"]]