Class GroupsApp

GroupsApp

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

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

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

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

พร็อพเพอร์ตี้Typeคำอธิบาย
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.");
}

พารามิเตอร์

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

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

รีเทิร์น

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

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

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

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