Class GroupsApp

GroupsApp

Class ini menyediakan akses ke informasi Google Grup. Dapat digunakan untuk membuat kueri informasi seperti alamat email grup, atau daftar grup tempat pengguna menjadi anggota langsung.

Berikut adalah contoh yang menunjukkan jumlah grup yang diikuti pengguna saat ini:

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

Properti

Properti	Jenis	Deskripsi
Role	Role

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
getGroupByEmail(email)	Group	Mengambil grup yang memiliki alamat email yang ditentukan.
getGroups()	Group[]	Mengambil semua grup yang Anda ikuti secara langsung (atau yang Anda ikuti dengan status menunggu persetujuan).

Dokumentasi mendetail

getGroupByEmail(email)

Mengambil grup yang memiliki alamat email yang ditentukan. Menampilkan pengecualian jika grup tidak ada atau jika Anda tidak memiliki izin untuk melihatnya.

Berikut adalah contoh yang mendapatkan grup berdasarkan alamat emailnya dan menampilkan apakah pengguna saat ini adalah anggota. Sebelum menjalankan, ganti alamat email contoh dengan email grup yang sebenarnya.

const group = GroupsApp.getGroupByEmail('[e-mail]');
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.');
}

Parameter

Nama	Jenis	Deskripsi
email	String	Alamat email grup yang akan diambil.

Pulang pergi

Group — Grup dengan alamat email yang ditentukan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getGroups()

Mengambil semua grup yang Anda ikuti secara langsung (atau yang Anda ikuti dengan status menunggu persetujuan). Ini adalah daftar kosong jika Anda tidak tergabung dalam grup mana pun. Menampilkan pengecualian jika grup tidak ada atau jika Anda tidak memiliki izin untuk melihatnya.

Berikut adalah contoh cara mencetak alamat email untuk setiap grup tempat pengguna berada:

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);
}

Perhatikan bahwa jika Anda adalah anggota grup B, yang merupakan anggota grup lain, A, maka Anda secara tidak langsung berlangganan ke grup A. Meskipun Anda menerima salinan pesan yang dikirim ke grup "induk" A, Anda sebenarnya tidak berlangganan grup tersebut.

Anda dapat menggunakan Group.getRole(email) untuk menentukan apakah Anda adalah anggota yang sudah ada atau menunggu persetujuan dari grup yang ditampilkan.

Pulang pergi

Group[] — Daftar grup yang mencantumkan pengguna sebagai anggota langsung.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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