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, giúp xác định những hành động mà họ được phép thực hiện trong phòng.

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 gói thành viên, chẳng hạn như thời điểm một thành viên tham gia hoặc được mời tham gia 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.
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 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ể đượ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 dưới dạng người dùng, thì kết quả sẽ điền sẵn name và type của người dùng.
groupMember

object (Group)

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

Bạn cần xác thực người dùng để đọc hoặc thay đổi thông tin thành viên của Google Groups.

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 tham gia không gian đang chờ xử lý.

MembershipRole

Biểu thị các hành động được phép của người dùng trong một không gian Chat. Các giá trị enum khác có thể được thêm vào trong tương lai.

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: các giá trị này 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ả các quyền cơ bản cùng với các 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ỉ 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 cho một Google Group.

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.