REST Resource: matters

• 資源：Matter
  • JSON 表示法
• 狀態
• MatterPermission
  • JSON 表示法
• AclRole
• 方法

資源：Matter

代表案件。

如要使用保管箱資源，帳戶必須具備必要的保管箱權限和案件存取權。如要存取案件，帳戶必須建立案件、擁有共用案件，或擁有「查看所有案件」權限。

JSON 表示法
{ "matterId": string, "name": string, "description": string, "state": enum (State), "matterPermissions": [ { object (MatterPermission) } ] }

欄位
matterId	string 伺服器產生的案件 ID。建立案件時留空，
name	string 案件的名稱。
description	string 案件的說明 (選填)。
state	enum (State) 案件的狀態。
matterPermissions[]	object (MatterPermission) 列出使用者及其權限針對案件的權限。目前，程式設計人員對於單一案件可擁有的權限數量並無定義限制。

狀態

案件的狀態。

列舉
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	案件擁有者。

方法
addPermissions	將帳戶新增為案件協作者。
close	關閉指定案件。
count	計算指定查詢處理的帳戶數量。
create	建立具備指定名稱和說明的案件。
delete	刪除指定案件。
get	取得指定案件。
list	列出要求者可存取的案件。
removePermissions	移除以案件協作者身分的帳戶。
reopen	重新開啟指定案件。
undelete	取消刪除指定的案件。
update	更新指定案件。