REST Resource: spaces.members

Tài nguyên: Thành viên

Thể hiện mối quan hệ thành viên trong Google Chat, chẳng hạn như người dùng hoặc ứng dụng Chat được mời tham gia, là một phần hay vắng mặt trong không gian.

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

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ể 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. Bất biến. 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. Bất biến. Thời gian xoá 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ỉ đượ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.

Trường kết hợp memberType. Thành viên 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 trạng thái sau đây:
member

object (User)

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 nametype.

groupMember

object (Group)

Nhóm Google tương ứng với tư cách thành viên.

MembershipState

Chỉ định mối quan hệ của thành viên với một không gian. Các trạng thái thành viên 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 vào 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 các cuộc trò chuyện nhóm 1:1 và 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ả các quyền cơ bản cùng với những quyền quản trị cho phép họ 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.

Đại diện cho một nhóm trong Cloud Identity Groups API.

Định dạng: nhóm/{group}

Phương thức

create

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

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ê thành viên trong một không gian.

patch

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