Service de paramètres des groupes du SDK Admin
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Le service Paramètres de groupe du SDK Admin vous permet d'utiliser l'API Groups Settings du SDK Admin dans Apps Script. Cette API permet aux administrateurs de domaines Google Workspace (y compris les revendeurs) de gérer les paramètres de groupe pour les groupes de leur compte Google Workspace.
Référence
Pour en savoir plus sur ce service, consultez la documentation de référence de l'API Groups Settings du SDK Admin. Comme tous les services avancés d'Apps Script, le service Admin SDK Groups Settings utilise les mêmes objets, méthodes et paramètres que l'API publique. Pour en savoir plus, consultez Déterminer les signatures de méthode.
Pour signaler des problèmes et obtenir de l'aide, consultez le guide d'assistance sur les paramètres de groupes du SDK Admin.
Exemple de code
L'exemple de code ci-dessous utilise la version 1 de l'API.
Obtenir les paramètres d'un groupe
Cet exemple récupère les paramètres d'un groupe et les consigne dans la console.
Modifier les paramètres d'un groupe
Cet exemple montre comment modifier les paramètres d'un groupe. Ici, la description est modifiée, mais vous pouvez modifier d'autres paramètres de la même manière.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 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"]]