Class GroupsApp

GroupsApp

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

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

const groups = GroupsApp.getGroups();
Logger.log(`You belong to ${groups.length} groups.`);

Thuộc tính

Thuộc tínhLoạiMô tả
RoleRole

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
getGroupByEmail(email)GroupTruy xuất nhóm có địa chỉ email được 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 được chỉ định. Gây ra 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 đó.

Dưới đây là một ví dụ về cách lấy một nhóm theo địa chỉ email và cho biết liệu 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 thực của nhóm. 

const group = GroupsApp.getGroupByEmail('example@googlegroups.com');
const 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.');
}

Tham số

TênLoạiMô tả
emailStringĐị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 được chỉ định.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu uỷ quyền bằng 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 là một danh sách trống nếu bạn không thuộc nhóm nào. Gây ra 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 đó.

Dưới đây là ví dụ về cách in địa chỉ email cho mọi nhóm mà người dùng thuộc về: 

function showMyGroups() {
  const groups = GroupsApp.getGroups();
  let str = `You are in ${groups.length} groups: `;
  for (let i = 0; i < groups.length; i++) {
    const group = groups[i];
    str = `${str + group.getEmail()} `;
  }
  Logger.log(str);
}
 Xin lưu ý rằng nếu bạn là thành viên của nhóm B (nhóm này là thành viên của một nhóm khác, A), thì bạn sẽ được đăng ký gián tiếp vào nhóm A. Mặc dù nhận được bản sao của các tin nhắn gửi đến nhóm A "mẹ", nhưng bạn không thực sự đăng ký vào nhóm đó.

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

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 yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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