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
Properti | Jenis | Deskripsi |
---|---|---|
Role | Role |
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
getGroupByEmail(email) | Group | Mengambil 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
Nama | Jenis | Deskripsi |
---|---|---|
email | String | Alamat 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