Class GroupsApp

GroupsApp

Kelas ini memberikan akses ke informasi Google Grup. Metode ini dapat digunakan untuk mengkueri informasi seperti alamat email grup, atau daftar grup tempat pengguna menjadi anggota langsung.

Berikut adalah contoh yang menampilkan jumlah grup tempat pengguna saat ini menjadi anggota:

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

Properti

PropertiJenisDeskripsi
RoleRole

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getGroupByEmail(email)GroupMengambil grup yang memiliki alamat email yang telah ditentukan.
getGroups()Group[]Mengambil semua grup tempat Anda menjadi anggota langsung (atau anggota yang menunggu keputusan).

Dokumentasi mendetail

getGroupByEmail(email)

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

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

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

Parameter

NamaJenisDeskripsi
emailStringAlamat email grup yang akan diambil.

Return

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 tempat Anda menjadi anggota langsung (atau anggota yang menunggu keputusan). Ini adalah daftar kosong jika Anda tidak berada 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() {
  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);
}
Perhatikan bahwa jika Anda adalah anggota grup, B, yang merupakan anggota grup lain, A, maka Anda secara tidak langsung berlangganan 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 grup yang ditampilkan, baik yang sudah ada maupun yang menunggu keputusan.

Return

Group[] — Daftar grup tempat pengguna menjadi anggota langsung.

Otorisasi

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

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