REST Resource: members

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

Thành viên Google Groups có thể là 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 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
}
Các trường
kind

string

Loại tài nguyên API. Đối với tài nguyên 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à người dùng hoặc một nhóm khác. Bạn phải sử dụng thuộc tính này khi thêm một 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 được thay đổi, API sẽ tự động phản ánh các thay đổi đối với địa chỉ email.
role

string

Vai trò của thành viên trong nhóm. API trả về lỗi cho các chu kỳ ở tư cách thành viên trong 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 một 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. Hãy xem phần BẬT hoặc TẮT Groups for Business. Vai trò MANAGER có thể làm mọi việc do vai trò OWNER thực hiện, ngoại trừ việc đặt một thành viên làm OWNER hoặc xóa nhóm. Một nhóm có thể có nhiều MANAGER thành viên.
  • MEMBER: Vai trò này có thể đăng ký theo dõi một nhóm, xem bản lưu trữ của các cuộc thảo luận và 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à 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 miền. Địa chỉ email không được trả về và mã nhận dạng được trả về chính là mã khách hàng.
  • EXTERNAL: Thành viên là người dùng hoặc nhóm từ bên ngoài 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 của thành viên (Không thể thay đổi)
delivery_settings

string

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

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

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

string

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

Phương thức

delete

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

get

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

hasMember

 Kiểm tra xem người dùng đã cho 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 đã 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 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.