REST Resource: members

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

Thành viên trong Google Groups có thể là một người dùng hoặc một nhóm khác. Thành viên này có thể ở trong hoặc ngoài miền của tài khoản của bạn. Để biết thêm thông tin về các thao tác phổ biến của thành viên nhóm, hãy xem Hướng dẫn dành cho nhà phát triển.

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "email": string,
  "role": string,
  "etag": string,
  "type": string,
  "status": string,
  "delivery_settings": string,
  "id": string
}
Trường
kind

string

Loại tài nguyên API. Đối với tài nguyên của Thành viên, giá trị là admin#directory#member.
email

string

Địa chỉ email của thành viên. Thành viên có thể là một người dùng hoặc một nhóm khác. Bạn phải cung cấp thuộc tính này khi thêm thành viên vào nhóm. email phải là duy nhất và không thể là bí danh của một nhóm khác. Nếu địa chỉ email thay đổi, API sẽ tự động phản ánh các thay đổi về địa chỉ email.
role

string

Vai trò của thành viên trong một nhóm. API trả về lỗi cho các chu kỳ trong thành viên nhóm. Ví dụ: nếu group1 là thành viên của group2, thì group2 không thể là thành viên của group1. Để biết thêm thông tin về vai trò của thành viên, hãy xem phần Chỉ định vai trò trong nhóm cho thành viên.

Các giá trị được chấp nhận là:

  • MANAGER: Vai trò này chỉ có sẵn nếu Google Groups for Business được bật bằng Bảng điều khiển dành cho quản trị viên. Xem bài viết BẬT hoặc TẮT Groups for Business. Vai trò MANAGER có thể làm mọi việc do vai trò OWNER làm, ngoại trừ việc chỉ định một thành viên làm OWNER hoặc xoá nhóm. Một nhóm có thể có nhiều thành viên MANAGER.
  • MEMBER: Vai trò này có thể đăng ký một nhóm, xem bản lưu trữ các cuộc thảo luận và xem danh sách thành viên của nhóm. Để biết thêm thông tin về vai trò của thành viên, hãy xem phần Chỉ định vai trò trong nhóm cho thành viên.
  • OWNER: Vai trò này có thể gửi tin nhắn cho nhóm, thêm hoặc xoá thành viên, thay đổi vai trò của thành viên, thay đổi chế độ cài đặt của nhóm và xoá nhóm. OWNER phải là một thành viên của nhóm. Một nhóm có thể có nhiều OWNER.
etag

string

ETag của tài nguyên.
type

string

Loại thành viên nhóm.

Các giá trị được chấp nhận là:

  • CUSTOMER: Thành viên đại diện cho tất cả người dùng trong một miền. Địa chỉ email sẽ không được trả về và mã nhận dạng được trả về là mã khách hàng.
  • EXTERNAL: Thành viên là một người dùng hoặc nhóm không thuộc miền. (Hiện không được sử dụng)
  • GROUP: Thành viên là một nhóm khác.
  • USER: Thành viên là một người dùng.
status

string

Trạng thái thành viên (Không thể thay đổi)
delivery_settings

string

Xác định lựa chọn ưu tiên gửi thư của thành viên. Trường này chỉ được hỗ trợ trong các phương thức insert, update và get.

Các giá trị được chấp nhận là:

  • ALL_MAIL: Tất cả tin nhắn, được gửi ngay khi tin nhắn đến.
  • DAILY: Không quá 1 tin nhắn mỗi ngày.
  • DIGEST: Tối đa 25 thư được nhóm vào một thư duy nhất.
  • DISABLED: Xoá gói thuê bao.
  • NONE: Không có thư.
id

string

Mã nhận dạng duy nhất của thành viên nhóm. Một thành viên id có thể được dùng làm memberKey của URI yêu cầu thành viên.

Phương thức

delete

 Xoá một thành viên khỏi nhóm.

get

 Truy xuất thuộc tính của một thành viên trong nhóm.

hasMember

 Kiểm tra xem người dùng cụ thể có phải là thành viên của nhóm hay không.

insert

 Thêm người dùng vào nhóm đã chỉ định.

list

 Truy xuất danh sách được phân trang của tất cả thành viên trong một nhóm.

patch

 Cập nhật các thuộc tính thành viên của một người dùng trong nhóm được chỉ định.

update

 Cập nhật tư cách thành viên của người dùng trong nhóm được chỉ định.