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 của Google Groups. Bạn có thể dùng mã 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:

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

Thuộc tính

Thuộc tính	Loại	Mô tả
`Role`	`Role`

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`getGroupByEmail(email)`	`Group`	Truy 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. Trả về 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 lấy một nhóm theo địa chỉ email của nhóm đó và xuất ra thông tin về việc 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.

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ên	Loại	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 được chỉ định.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 là một danh sách trống nếu bạn không thuộc bất kỳ nhóm nào. Trả về 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 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 một nhóm, B, mà chính nhóm này lại là thành viên của một nhóm khác, A, thì bạn đang gián tiếp đăng ký theo dõi nhóm A. Mặc dù nhận được bản sao của các thư gửi đến nhóm "mẹ" A, nhưng bạn thực sự không đăng ký theo dõ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

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

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