REST Resource: matters

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

資源：Matter

代表案件。

如要使用保管箱資源，帳戶必須具備必要的保管箱權限，並能存取案件。如要存取案件，帳戶必須是該案件的建立者、共用對象，或具備「查看所有案件」權限。

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	歐洲區域。

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