Admin SDK Groups Settings Service

  • The Admin SDK Groups Settings service in Apps Script allows Google Workspace administrators to manage group settings using the Admin SDK Groups Settings API.

  • This service is an advanced service that must be enabled before use.

  • The service uses the same objects, methods, and parameters as the public Admin SDK Groups Settings API.

  • Sample code is provided for getting and updating a group's settings.

The Admin SDK Groups Settings service lets you use the Admin SDK's Groups Settings API in Google 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.

This is an advanced service that must be enabled before use.

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 following sample code 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.
 */
functiongetGroupSettings(){
// TODO (developer) - Replace groupId value with yours
constgroupId="exampleGroup@example.com";
try{
constgroup=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
 */
functionupdateGroupSettings(){
constgroupId="exampleGroup@example.com";
try{
constgroup=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);
}
}

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026年05月04日 UTC.