REST Resource: spaces.members

Tài nguyên: Membership

Biểu thị mối quan hệ thành viên trong Google Chat, chẳng hạn như việc người dùng hoặc ứng dụng Chat được mời, là thành viên hay không tham gia một 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

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 một không gian trên Chat, vai trò này xác định những hành động được phép của người dùng 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. Không thể thay đổi. Thời gian tạo tư cách 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 một không gian. Trường này chỉ có đầu ra, trừ trường hợp được dùng để nhập thành viên cũ trong không gian ở chế độ nhập.
deleteTime

string (Timestamp format)

Không bắt buộc. Không thể thay đổi. Thời gian 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 một không gian. Trường này chỉ có đầu ra, trừ trường hợp được dùng để nhập thành viên cũ trong không gian ở chế độ nhập.
Trường nhóm 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 trạng thái sau:
member

object (User)

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

object (Group)

Không bắt buộc. Nhóm trên Google mà tư cách thành viên tương ứng.

Để đọc hoặc thay đổi thông tin về thành viên trong Nhóm trên Google, bạn cần phải xác thực người dùng.

MembershipState

Xác đị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ể sẽ đượ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ị những hành động được phép của người dùng trong một không gian trên Chat. Sau này, chúng tôi có thể thêm nhiều giá trị enum hơn.

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. Trong giao diện người dùng Chat, vai trò này được gọi là Thành viên.

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. Người quản lý và chủ sở hữu có thể cấp thêm quyền cho thành viên trong một không gian, bao gồm:

  • Thêm hoặc xoá thành viên.
  • Chỉnh sửa thông tin chi tiết của không gian.
  • Bật hoặc tắt nhật ký.
  • Đề cập đến mọi người trong không gian bằng @all.
  • Quản lý các ứng dụng và webhook trên Chat được cài đặt trong không gian.

Trong tin nhắn trực tiếp 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

Là chủ sở hữu không gian. Trong giao diện người dùng của tính năng trò chuyện, vai trò này được gọi là Chủ sở hữu.

Người dùng có toàn bộ các quyền đối với không gian để quản lý không gian, bao gồm:

  • Thay đổi vai trò của các thành viên khác trong không gian thành thành viên, người quản lý hoặc chủ sở hữu.
  • Xoá không gian.

Chỉ được hỗ trợ trong SpaceType.SPACE (không gian được đặt tên).

Để tìm hiểu thêm, hãy xem bài viết Tìm hiểu thêm về vai trò chủ sở hữu hoặc người quản lý không gian.
ROLE_ASSISTANT_MANAGER

Người quản lý không gian. Trong giao diện người dùng Chat, vai trò này được gọi là Người quản lý.

Người dùng này có tất cả các quyền cơ bản của ROLE_MEMBER và chủ sở hữu có thể cấp cho người dùng này một số quyền quản trị. Theo mặc định, người quản lý có mọi quyền của chủ sở hữu, ngoại trừ quyền:

  • Xoá không gian.
  • Chỉ định một thành viên khác trong không gian làm chủ sở hữu.
  • Thay đổi vai trò của chủ sở hữu.

Theo mặc định, quyền của người quản lý bao gồm nhưng không giới hạn ở:

  • Chỉ định thành viên khác làm người quản lý.
  • Xoá tin nhắn trong không gian.
  • Quản lý quyền của không gian.
  • Nhận thông báo về các yêu cầu tham gia không gian nếu người quản lý có quyền "quản lý thành viên" trong phần cài đặt không gian.
  • Tạo không gian mở.

Chỉ được hỗ trợ trong SpaceType.SPACE (không gian được đặt tên).

Để tìm hiểu thêm, hãy xem bài viết Quản lý chế độ cài đặt của không gian.

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 Nhóm trên Google.

Đại diện cho 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 gọi điện, người dùng hoặc Nhóm trên Google.

delete

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

patch

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