Serviço de configurações do Grupos do SDK Admin
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O serviço de configurações do Grupos do SDK Admin permite usar a API Groups Settings do SDK Admin no Apps Script. Essa API
permite que administradores de domínios do Google Workspace
(incluindo revendedores) gerenciem as configurações de grupos na
conta do Google Workspace.
Referência
Para informações detalhadas sobre esse serviço, consulte a
documentação de referência da
API Groups Settings do Admin SDK. Assim como todos os serviços avançados no Apps Script, o serviço
Admin SDK Groups Settings usa os mesmos objetos, métodos e parâmetros
que a API pública. Para mais informações, consulte Como as assinaturas de método são determinadas.
Para informar problemas e encontrar outras opções de suporte, consulte o
guia de suporte das configurações de grupos do SDK Admin.
Código de amostra
O exemplo de código abaixo usa a versão 1 da API.
Acessar as configurações de um grupo
Este exemplo recebe as configurações de um grupo e as registra no console.
Atualizar as configurações de um grupo
Este exemplo mostra como as configurações de um grupo podem ser alteradas. Aqui, a descrição
é modificada, mas várias outras configurações podem ser alteradas da mesma forma.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eThe Admin SDK Groups Settings service enables Google Workspace administrators to manage group settings within their accounts using Apps Script and the Groups Settings API.\u003c/p\u003e\n"],["\u003cp\u003eThis is an advanced service that requires enabling before use and mirrors the functionality of the public API.\u003c/p\u003e\n"],["\u003cp\u003eComprehensive 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.\u003c/p\u003e\n"]]],[],null,["# Admin SDK Groups Settings Service\n\nThe Admin SDK Groups Settings service allows you to use the Admin SDK's\n[Groups Settings API](/admin-sdk/groups-settings) in Apps Script. This API\ngives administrators of Google Workspace domains\n(including resellers) the ability to manage the group settings for groups in\ntheir Google Workspace account.\n| **Note:** This is an advanced service that must be [enabled before use](/apps-script/guides/services/advanced).\n\nReference\n---------\n\nFor detailed information on this service, see the\n[reference documentation](/admin-sdk/groups-settings/v1/reference) for the\nAdmin SDK Groups Settings API. Like all advanced services in Apps Script, the\nAdmin SDK Groups Settings service uses the same objects, methods, and parameters\nas the public API. For more information, see [How method signatures are determined](/apps-script/guides/services/advanced#how_method_signatures_are_determined).\n\nTo report issues and find other support, see the\n[Admin SDK Groups Settings support guide](/admin-sdk/groups-settings/support).\n\nSample code\n-----------\n\nThe sample code below uses [version 1](/admin-sdk/groups-settings/v1/reference)\nof the API.\n\n### Get a group's settings\n\nThis sample gets a group's settings and logs them to the console. \nadvanced/adminSDK.gs \n[View on GitHub](https://github.com/googleworkspace/apps-script-samples/blob/main/advanced/adminSDK.gs) \n\n```javascript\n/**\n * Gets a group's settings and logs them to the console.\n */\nfunction getGroupSettings() {\n // TODO (developer) - Replace groupId value with yours\n const groupId = 'exampleGroup@example.com';\n try {\n const group = AdminGroupsSettings.Groups.get(groupId);\n console.log(JSON.stringify(group, null, 2));\n } catch (err) {\n // TODO (developer)- Handle exception from the API\n console.log('Failed with error %s', err.message);\n }\n}\n```\n\n### Update a group's settings\n\nThis sample shows how a group's settings can be changed. Here, the description\nis modified, but various other settings can be changed in the same way.\n\n\nadvanced/adminSDK.gs \n[View on GitHub](https://github.com/googleworkspace/apps-script-samples/blob/main/advanced/adminSDK.gs) \n\n```javascript\n/**\n * Updates group's settings. Here, the description is modified, but various\n * other settings can be changed in the same way.\n * @see https://developers.google.com/admin-sdk/groups-settings/v1/reference/groups/patch\n */\nfunction updateGroupSettings() {\n const groupId = 'exampleGroup@example.com';\n try {\n const group = AdminGroupsSettings.newGroups();\n group.description = 'Newly changed group description';\n AdminGroupsSettings.Groups.patch(group, groupId);\n } catch (err) {\n // TODO (developer)- Handle exception from the API\n console.log('Failed with error %s', err.message);\n }\n}\n```\n\n\u003cbr /\u003e"]]