REST Resource: matters

Tài nguyên: Matter

Đại diện cho một vấn đề.

Để xử lý các tài nguyên trong Vault, tài khoản phải có các đặc quyền bắt buộc đối với Vault và quyền truy cập vào vấn đề. Để truy cập vào một vấn đề, tài khoản phải là người tạo vấn đề, được chia sẻ vấn đề hoặc có đặc quyền Xem tất cả vấn đề.

Biểu diễn dưới dạng JSON 
{
  "matterId": string,
  "name": string,
  "description": string,
  "state": enum (State),
  "matterPermissions": [
    {
      object (MatterPermission)
    }
  ],
  "matterRegion": enum (MatterRegion)
}
Trường
matterId

string

Mã vấn đề do máy chủ tạo. Để trống khi tạo vấn đề.
name

string

Tên của vấn đề.
description

string

Nội dung mô tả (không bắt buộc) về vấn đề.
state

enum (State)

Trạng thái của vấn đề.
matterPermissions[]

object (MatterPermission)

Liệt kê người dùng và quyền của họ đối với vấn đề này. Hiện tại, không có giới hạn nào do lập trình viên xác định về số lượng quyền mà một vấn đề có thể có.
matterRegion

enum (MatterRegion)

Không bắt buộc. Khu vực lưu trữ dữ liệu được yêu cầu cho vấn đề.

Tiểu bang

Trạng thái của một chất.

Enum
STATE_UNSPECIFIED Vấn đề này chưa có trạng thái cụ thể.
OPEN Vấn đề này đang được xem xét.
CLOSED Vấn đề này đã được giải quyết.
DELETED Vấn đề này đã bị xoá.

MatterPermission

Người dùng có thể là chủ sở hữu hoặc cộng tác viên của vấn đề. Mỗi vấn đề chỉ có một chủ sở hữu. Tất cả người dùng khác có thể truy cập vào vấn đề này đều là cộng tác viên. Khi một tài khoản bị xoá, các tài nguyên MatterPermission tương ứng của tài khoản đó sẽ không còn tồn tại.

Biểu diễn dưới dạng JSON 
{
  "role": enum (AclRole),
  "accountId": string
}
Trường
role

enum (AclRole)

Vai trò của người dùng đối với vấn đề.
accountId

string

Mã tài khoản do SDK quản trị cung cấp.

AclRole

Các quyền có thể có của người dùng đối với một vấn đề, theo thứ tự tăng dần về quyền.

Enum
ROLE_UNSPECIFIED Chưa có vai trò nào được chỉ định.
COLLABORATOR Một cộng tác viên liên quan đến vấn đề này.
OWNER Chủ sở hữu của vấn đề.

MatterRegion

Khu vực lưu trữ dữ liệu của vấn đề.

Enum
MATTER_REGION_UNSPECIFIED Khu vực chưa được chỉ định. Giá trị mặc định là BẤT KỲ.
ANY Mọi khu vực.
US Khu vực Hoa Kỳ.
EUROPE Khu vực Châu Âu.

Phương thức

addPermissions

 Thêm một tài khoản làm người cộng tác trong một vấn đề.

close

 Đóng vấn đề đã chỉ định.

count

 Đếm số tài khoản được xử lý theo truy vấn đã chỉ định.

create

 Tạo một vấn đề có tên và nội dung mô tả đã cho.

delete

 Xoá vấn đề đã chỉ định.

get

 Lấy vấn đề được chỉ định.

list

 Liệt kê các vấn đề mà người yêu cầu có quyền truy cập.

removePermissions

 Xoá tài khoản khỏi vai trò cộng tác viên trong một vấn đề.

reopen

 Mở lại vấn đề đã chỉ định.

undelete

 Huỷ xoá vấn đề đã chỉ định.

update

 Cập nhật vấn đề đã chỉ định.