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 này phải có các đặc quyền cần thiết 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 là người đã tạo vấn đề, đã chia sẻ vấn đề đó với họ 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)
    }
  ]
  "matter_region": enum (MatterRegion),
}
Trường
matterId

string

Mã vấn đề do máy chủ tạo. Để 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 đề này.
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ó.
matter_region

enum (MatterRegion)

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

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 được chỉ định.
OPEN Vấn đề này đang được xử lý.
CLOSED Vấn đề đã được đóng.
DELETED Vấn đề đã bị xóa.

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ả những người dùng khác có thể truy cập vào vấn đề đề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
}
Trường
role

enum (AclRole)

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

string

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

AclRole

Các quyền mà 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 đề.

Vùng Matter

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

Enum
MATTER_REGION_UNSPECIFIED Vấn đề này chưa chỉ định khu vực lưu trữ dữ liệu.
ANY Vấn đề này chưa chỉ định khu vực lưu trữ dữ liệu.
US Vấn đề này có một khu vực lưu trữ dữ liệu ở Hoa Kỳ.
EU Vấn đề này có một khu vực lưu trữ dữ liệu thuộc Liên minh Châu Âu.

Phương thức

addPermissions

 Thêm một tài khoản làm cộng tác viên của Matter.

close

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

count

 Đếm các tài khoản được xử lý theo truy vấn được 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

 Xem vấn đề đã chỉ định.

list

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

removePermissions

 Xoá một tài khoản khỏi vai trò cộng tác viên của Matter.

reopen

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

undelete

 Khôi phục vấn đề đã chỉ định.

update

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