REST Resource: spaces.members

Tài nguyên: Tư cách thành viên

Biểu thị mối quan hệ thành viên trong Google Chat, chẳng hạn như liệu người dùng hoặc ứng dụng Chat có được mời tham gia, có tham gia hay không tham gia không gian hay không.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "state": enum (MembershipState),
  "role": enum (MembershipRole),
  "createTime": string,
  "deleteTime": string,

  // Union field memberType can be only one of the following:
  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
  // End of list of possible types for union field memberType.
}
Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của gói thành viên do máy chủ chỉ định.

Định dạng spaces/{space}/members/{member}
state

enum (MembershipState)

Chỉ có đầu ra. Trạng thái của gói thành viên.
role

enum (MembershipRole)

Không bắt buộc. Vai trò của người dùng trong phòng Chat. Vai trò này xác định những hành động được phép họ thực hiện trong không gian đó.

Bạn chỉ có thể sử dụng trường này làm dữ liệu đầu vào trong members.patch.
createTime

string (Timestamp format)

Không bắt buộc. Không thể thay đổi. Thời gian tạo thành viên, chẳng hạn như thời điểm thành viên tham gia hoặc được mời tham gia không gian. Trường này chỉ được cung cấp cho kết quả đầu ra, trừ phi trường này được dùng để nhập tư cách thành viên trước đây vào không gian ở chế độ nhập.
deleteTime

string (Timestamp format)

Không bắt buộc. Không thể thay đổi. Thời điểm xoá tư cách thành viên, chẳng hạn như khi một thành viên rời khỏi hoặc bị xoá khỏi không gian. Trường này chỉ xuất, ngoại trừ khi được dùng để nhập gói thành viên trước đây trong các không gian ở chế độ nhập.
Trường hợp hợp nhất memberType. Thành viên được liên kết với gói thành viên này. Các loại thành viên khác có thể sẽ được hỗ trợ trong tương lai. memberType chỉ có thể là một trong những giá trị sau:
member

object (User)

Không bắt buộc. Người dùng hoặc ứng dụng Google Chat tương ứng với gói thành viên. Nếu ứng dụng Chat xác thực với tư cách là một người dùng, thì dữ liệu đầu ra sẽ được điền cho người dùng name và type.
groupMember

object (Group)

Không bắt buộc. Nhóm Google tương ứng với gói thành viên.

Việc đọc hoặc thay đổi tư cách thành viên trong Google Groups yêu cầu xác thực người dùng.

MembershipState

Chỉ định mối quan hệ của thành viên với một không gian. Các tiểu bang khác có thể được hỗ trợ trong tương lai.

Enum
MEMBERSHIP_STATE_UNSPECIFIED Giá trị mặc định. Không sử dụng.
JOINED Người dùng được thêm vào không gian và có thể tham gia không gian.
INVITED Người dùng được mời tham gia không gian nhưng chưa tham gia.
NOT_A_MEMBER Người dùng không thuộc không gian và không có lời mời đang chờ xử lý để tham gia không gian.

MembershipRole

Biểu thị các hành động được phép của người dùng trong phòng Chat. Trong tương lai, có thể sẽ thêm các giá trị enum khác.

Enum
MEMBERSHIP_ROLE_UNSPECIFIED Giá trị mặc định. Đối với users: họ không phải là thành viên của không gian nhưng có thể được mời. Đối với Google Groups: họ luôn được chỉ định vai trò này (các giá trị enum khác có thể được sử dụng trong tương lai).
ROLE_MEMBER Một thành viên của không gian. Người dùng có các quyền cơ bản, chẳng hạn như gửi tin nhắn đến không gian. Trong cuộc trò chuyện 1:1 và cuộc trò chuyện nhóm chưa đặt tên, mọi người đều có vai trò này.
ROLE_MANAGER Người quản lý không gian. Người dùng có tất cả quyền cơ bản cùng với quyền quản trị để quản lý không gian, chẳng hạn như thêm hoặc xoá thành viên. Chỉ được hỗ trợ trong SpaceType.SPACE.

Nhóm

Một nhóm trên Google Groups trong Google Chat.

Biểu diễn dưới dạng JSON 
{
  "name": string
}
Trường
name

string

Tên tài nguyên của một nhóm trên Google Groups.

Biểu thị một nhóm trong Cloud Identity Groups API.

Định dạng: groups/{group}

Phương thức

create

 Tạo tư cách thành viên cho ứng dụng Chat đang gọi, người dùng hoặc Nhóm trên Google.

delete

 Xoá gói thành viên.

get

 Trả về thông tin chi tiết về một gói thành viên.

list

 Liệt kê các gói thành viên trong một không gian.

patch

 Cập nhật gói thành viên.