Расширенная служба Cloud Identity Groups (CIG) обеспечивает функциональность, аналогичную API Groups Service , и может использоваться вместо него.
Ознакомьтесь со вспомогательными методами, чтобы узнать, как достичь эквивалентных возможностей с помощью CIG Advanced Service.
Настраивать
Чтобы использовать CIG Advanced Service, сначала включите его в своем проекте скрипта.
Чтобы сократить некоторые сигнатуры методов в этом руководстве, мы определили следующую переменную:
const groups = CloudIdentityGroups.Groups;
Методы GroupsApp
Следующие вспомогательные методы соответствуют методам Groups Service GroupsApp .
В этом руководстве термин «группа» относится к ресурсу группы , а не к объекту класса группы . Ресурсы группы — это объекты JavaScript без методов, но их можно использовать в CIG Advanced Service для получения информации, аналогичной той, что содержится в объектах класса группы .
getGroupByEmail
/**
* Given a group's email, returns that group's resource
*
* @param {String} email: The email address to lookup a group by
* @return {Group} group: The group resource associated with the email
*/
function groupsAppGetGroupByEmail(email) {
// Retrieve the name ID of the group
const groupName = groups.lookup({
'groupKey.id': email,
'groupKey.namespace': '' // Optional for google groups, dynamic groups, and security groups
// Necessary for identity-mapped groups (see https://developers.google.com/cloud-search/docs/guides/identity-mapping)
}).name;
// Retrieve the group resource
return groups.get(groupName);
}
getGroups
Следующий вспомогательный метод возвращает список ресурсов членства . Доступ к полю group элемента, чтобы узнать его идентификатор имени. Это полезно для многих методов CIG Advanced Service. Аналогично, доступ к groupKey.id элемента, чтобы узнать его адрес электронной почты.
/**
* Retrieves all the membership relation resources to groups which you are a
* direct member (or a pending member).
*
* @return {Array<MembershipRelation>} groups : List of direct memberships where
* you are the member.
*/
function groupsAppGetGroups() {
const myEmail = Session.getActiveUser().getEmail();
let pageToken = '';
let membershipList = [];
do {
const queryParams = {
query:`member_key_id=='${myEmail}'`,
pageToken:pageToken
};
const searchResult = groups.Memberships.searchDirectGroups('groups/-', queryParams);
membershipList = membershipList.concat(searchResult.memberships);
pageToken = searchResult.nextPageToken;
} while (pageToken);
return membershipList;
}
Групповые методы
Следующие вспомогательные методы соответствуют методам Groups Class .
получитьEmail
/**
* Gets a group's email address
*
* @param {Object} group: A group resource
* @return {String} email: The email associated with the group resource.
*/
function getEmail(group) {
return group.groupKey.id;
}
getGroups
Следующий метод использует Memberships.list , который извлекает все данные о членстве в указанной группе. Это может включать как членство пользователей, так и членство в группах.
Чтобы лучше аппроксимировать метод getGroups сервиса Groups, мы можем фильтровать членство по его Type . Доступ к этому полю можно получить, либо указав FULL View в качестве параметра запроса Memberships.list , либо выполнив отдельный запрос Memberships.lookup для каждого членства.
/**
* Fetch a list of memberships with provided group as its parent
*
* @param {Group} group: A group resource
* @return {Array<Membership>} membershipList: The memberships where the parent
* is the provided group and member is a also a group.
*/
function getGroups(group) {
let membershipList = [];
let pageToken = '';
do {
// Fetch a page of memberships
const queryParams = {
view: 'FULL',
pageToken: pageToken
}
const response = groups.Memberships.list(group.name, queryParams);
// Filter non-group memberships
const onlyGroupMemberships = response.memberships.filter(
membership => membership.type == 'GROUP'
);
membershipList = membershipList.concat(onlyGroupMemberships);
// Set up next page
pageToken = response.nextPageToken;
} while(pageToken);
return membershipList;
}
getRole и getRoles
Хотя служба групп могла вернуть только роль с наивысшим приоритетом в getRole() , поле roles в ресурсе членства содержит отдельный элемент для каждой роли, на которую имеет право участник (например: MEMBER, OWNER, ADMIN).
/**
* Retrieve the membership roles of a member to a group.
*
* @param {Group} containingGroup: The group whom the member belongs to
* @param {String} email: The email address associated with a member that
* belongs to the containingGroup
* @return {Array<Role>} roles: List of roles the member holds with respect to
* the containingGroup.
*/
function getRoleWithEmail(containingGroup, email) {
// First fetch the membership
const membershipName = groups.Memberships.lookup(containingGroup.name, { 'memberKey.id': email }).name;
const membership = groups.Memberships.get(membershipName);
// Then retrieve the role
return membership.roles;
}
/**
* Retrieve the membership roles of a member to a group.
*
* @param {Group} containingGroup: The group resource whom the member belongs to
* @param {User} user: The user associated with a member that belongs to the
* containingGroup
* @return {Array<Role>} roles: List of roles the member holds with respect to
* the containingGroup
*/
function getRoleWithUser(containingGroup, user) {
return getRoleWithEmail(containingGroup, user.getEmail());
}
/**
* Retrieve the membership roles of a group of members to a group
*
* @param {Group} containingGroup: The group resource to which roles are
* relevant
* @param {Array<User>} users: List of users to fetch roles from
* @return {Array<Array<Role>>} roles: A list where every element is a list of
* roles of member to the containingGroup
*/
function getRoles(containingGroup, users) {
let roles = [];
for (const user of users) {
roles.push(getRoleWithUser(containingGroup, user));
}
return roles;
}
получитьПользователи
Аналогично нашему подходу в getGroups мы можем извлечь данные о членстве в группе с помощью Memberships.list и отфильтровать результаты, чтобы оставить только целевой Type .
/**
* Given a group, retrieve its direct members and banned members of the group
* that have a known corresponding Google Account.
*
* @param {Group} group: The group Resource whom the users being queried belong
* to
* @return {Array<String>} users: A list of emails associated with members of
* the given group
*/
function getUsers(group) {
let userList = [];
let pageToken = '';
do {
// Fetch a page of memberships from the group
const queryParams = {
view: 'FULL',
pageToken: pageToken
}
const listResponse = groups.Memberships.list(group.name, queryParams);
// Filter non-users and keep member emails
const users = listResponse.memberships
.filter(membership => membership.type == 'USER')
.map(membership => membership.preferredMemberKey.id);
userList = userList.concat(users);
// Prepare next page
pageToken = listResponse.nextPageToken;
} while (pageToken);
return userList;
}
hasGroup и hasUser
Оба сервиса Groups Service hasGroup и hasUser проверяют принадлежность объекта к заданной группе. Учитывая, что и группа, и пользователь могут быть представлены адресом электронной почты, для проверки принадлежности любого из них к заданной группе можно использовать следующий метод.
/**
* Tests if the given email has an associated direct member to the given group.
*
* @param {Group} group: Group resource to which the entity is being checked as
* a member
* @param {String} email: Email that can represent a Group or User entity
* @return {Boolean} isMember: Whether the entity is a direct member to the
* group or not
*/
function checkDirectGroupMembership(group, email) {
try {
groups.Memberships.lookup(group.name, {'memberKey.id': email});
} catch(e) {
// Log failure if exception is not related to membership existence
if (!e.message.includes('Membership does not exist.')) {
console.error(e);
}
return false;
}
return true;
}