Class GroupsApp

แอป Groups

คลาสนี้ให้สิทธิ์เข้าถึงข้อมูล Google Groups ซึ่งสามารถใช้เพื่อค้นหาข้อมูล เช่น อีเมลของกลุ่ม หรือรายชื่อกลุ่มที่ผู้ใช้เป็นสมาชิกโดยตรง

ต่อไปนี้คือตัวอย่างที่แสดงจํานวนกลุ่มที่ผู้ใช้ปัจจุบันเป็นสมาชิก

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

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
Role	Role

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
getGroupByEmail(email)	Group	ดึงข้อมูลกลุ่มที่มีอีเมลที่ระบุ
getGroups()	Group[]	ดึงข้อมูลกลุ่มทั้งหมดที่คุณเป็นสมาชิกโดยตรง (หรือสมาชิกที่รอดำเนินการ)

เอกสารประกอบโดยละเอียด

getGroupByEmail(email)

ดึงข้อมูลกลุ่มที่มีอีเมลที่ระบุ แสดงข้อยกเว้นหากกลุ่มนั้นไม่มีอยู่หรือคุณไม่มีสิทธิ์ดู

ต่อไปนี้คือตัวอย่างที่รับกลุ่มตามอีเมลและแสดงผลว่าผู้ใช้ปัจจุบันเป็นสมาชิกหรือไม่ ก่อนเรียกใช้ ให้แทนที่อีเมลตัวอย่างด้วยอีเมลของกลุ่มจริง

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
email	String	อีเมลของกลุ่มที่จะดึงข้อมูล

รีเทิร์น

Group — กลุ่มที่มีอีเมลที่ระบุ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

---

getGroups()

ดึงข้อมูลกลุ่มทั้งหมดที่คุณเป็นสมาชิกโดยตรง (หรือสมาชิกที่รอดำเนินการ) รายการนี้จะว่างเปล่าหากคุณไม่ได้อยู่ในกลุ่มใดเลย แสดงข้อยกเว้นหากกลุ่มนั้นไม่อยู่หรือคุณไม่มีสิทธิ์ดู

ต่อไปนี้คือตัวอย่างวิธีพิมพ์อีเมลของทุกกลุ่มที่ผู้ใช้สังกัดอยู่

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

โปรดทราบว่าหากคุณเป็นสมาชิกของกลุ่ม B ซึ่งเป็นสมาชิกของอีกกลุ่มหนึ่งคือกลุ่ม A แสดงว่าคุณติดตามกลุ่ม A โดยอ้อม แม้ว่าคุณจะได้รับสำเนาข้อความที่ส่งไปยังกลุ่ม "หลัก" ก แต่คุณไม่ได้สมัครรับข้อมูลจากกลุ่มนั้น

คุณสามารถใช้ Group.getRole(email) เพื่อระบุว่าคุณเป็นสมาชิกเดิมหรือสมาชิกที่รอดําเนินการของกลุ่มที่แสดงผล

รีเทิร์น

Group[] — รายชื่อกลุ่มที่ผู้ใช้เป็นสมาชิกโดยตรง

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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