Halaman ini diterjemahkan oleh Cloud Translation API.

Class GroupsApp

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

Berikut adalah contoh yang menunjukkan 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 ditentukan.
`getGroups()`	`Group[]`	Mengambil semua grup tempat Anda merupakan anggota langsung (atau anggota yang menunggu keputusan).

Dokumentasi mendetail

`getGroupByEmail(email)`

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

Berikut contoh yang mendapatkan grup berdasarkan alamat emailnya dan menampilkan output pengguna adalah anggota. Sebelum menjalankan, ganti alamat email contoh dengan email grup asli.

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.

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 tempat Anda merupakan anggota langsung (atau anggota yang menunggu keputusan). Ini adalah daftar kosong jika Anda tidak ada 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 dikirim ke "induk" grup A, Anda tidak benar-benar berlangganan grup itu.

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

Pulang pergi

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