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 các miền của tài khoản. Để biết thêm thông tin về các việc cần làm 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 dành cho 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. Thuộc tính này là bắt buộc khi thêm thành viên vào một nhóm. email phải là duy nhất và không được 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 nhóm. API trả về lỗi cho các chu kỳ trong gói 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 bài viết 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 bạn bật Google Groups for Business 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 mà vai trò OWNER có thể làm, ngoại trừ việc chỉ định 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ý theo dõi một nhóm, xem bản lưu trữ 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 bài viết 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 trong 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. Hệ thống không trả về địa chỉ email 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 bên ngoài miền. (Hiện không dùng)
  • GROUP: Thành viên là một nhóm khác.
  • USER: Thành viên là 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 lựa chọn ưu tiên về việc 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ả thư, được gửi ngay khi đến.
  • DAILY: Không gửi quá một tin nhắn mỗi ngày.
  • DIGEST: Tối đa 25 thư được nhóm vào một thư.
  • DISABLED: Xoá gói thuê bao.
  • NONE: Không có thông báo.
id

string

Mã nhận dạng duy nhất của thành viên trong nhóm. Bạn có thể dùng id thành viên 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 các thuộc tính của 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 được chỉ định.

list

 Truy xuất danh sách phân trang gồm tất cả thành viên trong một nhóm.

patch

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

update

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