Groups Service

群組

這項服務可讓指令碼存取 Google 群組。可用於查詢群組的電子郵件地址等資訊，或使用者直接所屬的群組清單。以下範例顯示目前使用者所屬的群組數量：

var groups = GroupsApp.getGroups();
Logger.log('You are a member of %s Google Groups.', groups.length);

類別

名稱	簡短說明
Group	群組物件，可查詢群組成員和這些成員在群組中的角色。
GroupsApp	這個類別可存取 Google 群組資訊。
Role	使用者在群組中的可能角色，例如擁有者或一般成員。

Group

方法

方法	傳回類型	簡短說明
getEmail()	String	取得這個群組的電子郵件地址。
getGroups()	Group[]	擷取群組的直屬子群組。
getRole(email)	Role	擷取使用者在群組中的角色。
getRole(user)	Role	擷取使用者在群組中的角色。
getRoles(users)	Role[]	擷取使用者在群組中的角色。
getUsers()	User[]	取得群組的直接成員和遭禁止成員，這些成員都有對應的已知 Google 帳戶。
hasGroup(group)	Boolean	測試群組是否為這個群組的直接成員。
hasGroup(email)	Boolean	測試群組是否為這個群組的直接成員。
hasUser(email)	Boolean	測試使用者是否為群組的直接成員。
hasUser(user)	Boolean	測試使用者是否為群組的直接成員。

GroupsApp

屬性

屬性	類型	說明
Role	Role

方法

方法	傳回類型	簡短說明
getGroupByEmail(email)	Group	擷取具有指定電子郵件地址的群組。
getGroups()	Group[]	擷取您是直接成員 (或待處理成員) 的所有群組。

Role

屬性

屬性	類型	說明
OWNER	Enum	群組擁有者。
MANAGER	Enum	群組管理員。
MEMBER	Enum	使用者是這個群組的成員，但不是擁有者或管理員。
INVITED	Enum	使用者已受群組擁有者或管理員邀請加入群組，但尚未接受邀請。
PENDING	Enum	使用者已要求加入群組，但尚未獲得業主或管理員核准。
BANNED	Enum	使用者遭群組停權，無法嘗試加入群組。