Class GroupsApp

GroupsApp

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

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

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

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

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

เมธอด

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

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

getGroupByEmail(email)

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

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

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

พารามิเตอร์

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

รีเทิร์น

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 โดยอ้อม แม้ว่าคุณจะได้รับสำเนาข้อความที่ส่งไปยังกลุ่ม A ซึ่งเป็น "กลุ่มหลัก" แต่คุณไม่ได้สมัครรับข้อมูลจากกลุ่มนั้นจริงๆ

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

รีเทิร์น

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

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

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

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