REST Resource: matters

• 资源：事项
  • 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 账号 ID（由 Admin SDK 提供）。

AclRole

某项支持请求的可能用户权限，按权限递增顺序排列。

枚举
ROLE_UNSPECIFIED	未分配任何角色。
COLLABORATOR	相关事宜的协作者。
OWNER	相关事宜的所有者。

MatterRegion

相关事项的数据区域。

枚举
MATTER_REGION_UNSPECIFIED	地区未指定。默认值为 ANY。
ANY	任何区域。
US	美国区域。
EUROPE	欧洲地区。

方法
addPermissions	将账号添加为案件协作者。
close	关闭指定的支持请求。
count	统计指定查询处理的账号数。
create	使用给定的名称和说明创建诉讼或调查。
delete	删除指定的事项。
get	获取指定的事项。
list	列出请求者有权访问的诉讼或调查。
removePermissions	移除某个账号的相关支持请求协作者身份。
reopen	重新打开指定的支持请求。
undelete	取消删除指定的事项。
update	更新指定的事项。