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)
    }
  ]
  "matter_region": 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 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 đề 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 đề 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 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 đề.

Vùng Matter

Vùng 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 đề không có khu vực lưu trữ dữ liệu được chỉ định.
US Vấn đề có 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 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ê 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 với tư cách 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.