Admin SDK Groups Settings Service

  • The Admin SDK Groups Settings service enables Google Workspace administrators to manage group settings within their accounts using Apps Script and the Groups Settings API.

  • This is an advanced service that requires enabling before use and mirrors the functionality of the public API.

  • Comprehensive reference documentation, support resources, and sample code are available to guide developers in using this service effectively, including examples for retrieving and updating group settings.

The Admin SDK Groups Settings service allows you to use the Admin SDK's Groups Settings API in Apps Script. This API gives administrators of Google Workspace domains (including resellers) the ability to manage the group settings for groups in their Google Workspace account.

Reference

For detailed information on this service, see the reference documentation for the Admin SDK Groups Settings API. Like all advanced services in Apps Script, the Admin SDK Groups Settings service uses the same objects, methods, and parameters as the public API. For more information, see How method signatures are determined.

To report issues and find other support, see the Admin SDK Groups Settings support guide.

Sample code

The sample code below uses version 1 of the API.

Get a group's settings

This sample gets a group's settings and logs them to the console.

advanced/adminSDK.gs
/**  * Gets a group's settings and logs them to the console.  */ function getGroupSettings() {  // TODO (developer) - Replace groupId value with yours  const groupId = 'exampleGroup@example.com';  try {  const group = AdminGroupsSettings.Groups.get(groupId);  console.log(JSON.stringify(group, null, 2));  } catch (err) {  // TODO (developer)- Handle exception from the API  console.log('Failed with error %s', err.message);  } }

Update a group's settings

This sample shows how a group's settings can be changed. Here, the description is modified, but various other settings can be changed in the same way.

advanced/adminSDK.gs
/**  * Updates group's settings. Here, the description is modified, but various  * other settings can be changed in the same way.  * @see https://developers.google.com/admin-sdk/groups-settings/v1/reference/groups/patch  */ function updateGroupSettings() {  const groupId = 'exampleGroup@example.com';  try {  const group = AdminGroupsSettings.newGroups();  group.description = 'Newly changed group description';  AdminGroupsSettings.Groups.patch(group, groupId);  } catch (err) {  // TODO (developer)- Handle exception from the API  console.log('Failed with error %s', err.message);  } }