Trang này được dịch bởi Cloud Translation API.

Class GroupsApp

Lớp này cung cấp quyền truy cập vào thông tin về Google Groups. Bạn có thể dùng truy vấn này để truy vấn thông tin như địa chỉ email của nhóm hoặc danh sách nhóm mà người dùng là thành viên trực tiếp.

Dưới đây là ví dụ cho thấy số lượng nhóm mà người dùng hiện tại là thành viên:

var groups = GroupsApp.getGroups();
Logger.log('You belong to ' + groups.length + ' groups.');

Thuộc tính

Tài sản	Loại	Nội dung mô tả
`Role`	`Role`

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
`getGroupByEmail(email)`	`Group`	Truy xuất nhóm có địa chỉ email đã chỉ định.
`getGroups()`	`Group[]`	Truy xuất tất cả các nhóm mà bạn là thành viên trực tiếp (hoặc thành viên đang chờ xử lý).

Tài liệu chi tiết

`getGroupByEmail(email)`

Truy xuất nhóm có địa chỉ email đã chỉ định. Gửi ngoại lệ nếu nhóm không tồn tại hoặc nếu bạn không có quyền xem nhóm đó.

Dưới đây là ví dụ lấy nhóm theo địa chỉ email và cho biết người dùng hiện tại có phải là thành viên hay không. Trước khi chạy, hãy thay thế địa chỉ email mẫu bằng email của một nhóm thực.

var group = GroupsApp.getGroupByEmail("example@googlegroups.com");
var currentUser = Session.getActiveUser();
if (group.hasUser(currentUser)) {
  Logger.log("You are a member of this group.");
}
else {
  Logger.log("You are not a member of this group.");
}

Các tham số

Tên	Loại	Nội dung mô tả
`email`	`String`	Địa chỉ email của nhóm cần truy xuất.

Cầu thủ trả bóng

Group – Nhóm có địa chỉ email đã chỉ định.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/groups

`getGroups()`

Truy xuất tất cả các nhóm mà bạn là thành viên trực tiếp (hoặc thành viên đang chờ xử lý). Đây sẽ là một danh sách trống nếu bạn không thuộc bất kỳ nhóm nào. Gửi một ngoại lệ nếu nhóm không tồn tại hoặc nếu bạn không có quyền xem nhóm đó.

Sau đây là ví dụ về cách in địa chỉ email cho mỗi nhóm mà người dùng là thành viên:

function showMyGroups() {
  var groups = GroupsApp.getGroups();
  var str = 'You are in ' + groups.length + ' groups: ';
  for (var i = 0; i < groups.length; i++) {
    var group = groups[i];
    str = str + group.getEmail() + ' ';
  }
  Logger.log(str);
}

Lưu ý rằng nếu là thành viên của nhóm B và cũng là thành viên của một nhóm khác, A, thì bạn sẽ gián tiếp đăng ký vào nhóm A. Mặc dù bạn nhận được bản sao của các thông báo gửi đến nhóm "mẹ" A, nhưng bạn không thực sự đăng ký với nhóm đó.

Bạn có thể sử dụng Group.getRole(email) để xác định xem bạn là thành viên hiện tại hay đang chờ xử lý của các nhóm được trả về.

Cầu thủ trả bóng

Group[] – Danh sách các nhóm mà người dùng là thành viên trực tiếp.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

https://www.googleapis.com/auth/groups