Class GroupsApp

แอป Groups

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

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

var groups = GroupsApp.getGroups();
Logger.log('You belong to ' + groups.length + ' groups.');

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

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

เมธอด

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

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

getGroupByEmail(email)

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

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

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

พารามิเตอร์

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

ไปกลับ

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

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

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

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

getGroups()

เรียกดูกลุ่มทั้งหมดที่คุณเป็นสมาชิกโดยตรง (หรือเป็นสมาชิกที่รอดําเนินการ) รายการนี้ว่างเปล่าหากไม่ได้อยู่ในกลุ่มใดๆ ระบุข้อยกเว้นหากกลุ่มไม่มีอยู่หรือคุณไม่ได้รับอนุญาตให้ดู

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

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

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

ไปกลับ

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

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

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

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