Halaman ini diterjemahkan oleh Cloud Translation API.

Class GroupsApp

Class ini memberikan akses ke informasi Google Grup. ID ini dapat digunakan untuk membuat kueri informasi seperti alamat email grup, atau daftar grup tempat pengguna adalah anggota langsung.

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

const 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 yang anggota langsungnya adalah Anda (atau anggota yang tertunda).

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 merupakan anggota. Sebelum menjalankan, ganti alamat email contoh dengan email grup yang sebenarnya.

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

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 anggota langsungnya adalah Anda (atau anggota yang tertunda). Daftar ini adalah daftar kosong jika Anda tidak berada dalam grup apa 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 yang diikuti pengguna:

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 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 yang sudah ada atau tertunda.

Pulang pergi

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

Otorisasi

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

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