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, tham gia 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,
  "affiliation": enum (Affiliation),

  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
}
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 phòng Chat, xác định những hành động được phép của họ trong phòng đó.

Bạn chỉ có thể dùng trường này làm thông tin đầ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 tư cách thành viên trước đây 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 tư cách thành viên trước đây trong không gian ở chế độ nhập.
affiliation

enum (Affiliation)

Chỉ có đầu ra. Mối quan hệ của người dùng với tổ chức Workspace sở hữu không gian. Trong không gian thuộc tài khoản người tiêu dùng, mối quan hệ của tất cả thành viên là EXTERNAL.
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 người dùng name và type.
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

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ể 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 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 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 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 Chat, 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ê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 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ê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}

Đơn vị liên kết

Biểu thị mối liên kết của người dùng với tổ chức Google Workspace sở hữu không gian. Enum này có thể có thêm các giá trị trong tương lai.

Enum
AFFILIATION_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
INTERNAL Một tài khoản do cùng một tổ chức Google Workspace quản lý và tổ chức này sở hữu không gian.
EXTERNAL Một tài khoản bên ngoài tổ chức Google Workspace sở hữu không gian (ví dụ: tài khoản người dùng cá nhân hoặc tài khoản do một tổ chức Workspace khác quản lý).
MANAGED_EXTERNAL Một tài khoản do tổ chức Workspace sở hữu không gian quản lý, nhưng được cấp cho một người dùng bên ngoài tổ chức (ví dụ: người dùng Khách). Để tìm hiểu thêm về khách, hãy xem bài viết https://support.google.com/chat/answer/16997417.

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 một gói thành viên.