REST Resource: matters

Tài nguyên: Matter

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

Để làm việc với các tài nguyên của Vault, tài khoản phải có các đặc quyền bắt buộc của 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 đã tạo vấn đề, chia sẻ vấn đề với họ hoặc có đặc quyền Xem tất cả các vấn đề.

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

string

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

string

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

string

Nội dung mô tả không bắt buộc cho 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 đề. Hiện tại, không có giới hạn nào do người lập trình xác định về số lượng quyền mà một vấn đề có thể có.

Tiểu bang

Trạng thái của một vấn đề.

Enum
STATE_UNSPECIFIED Vấn đề không có trạng thái nào được chỉ định.
OPEN Vấn đề này đang được mở.
CLOSED Vấn đề này đã được đóng lại.
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 quan trọng. Mỗi vấn đề chỉ có một chủ sở hữu. Tất cả những 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á hoàn toàn, 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
}
Các 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 người dùng có thể có đối với một vấn đề, theo thứ tự tăng quyền.

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

Phương thức

addPermissions

 Thêm một tài khoản làm cộng tác viên cho vấn đề.

close

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

count

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

create

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

delete

 Xoá vấn đề được chỉ định.

get

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

list

 Danh sách các vấn đề mà người yêu cầu có quyền truy cập.

removePermissions

 Xoá một tài khoản với tư cách cộng tác viên cho vấn đề.

reopen

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

undelete

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

update

 Cập nhật vấn đề được chỉ định.