Groups Settings API 概览
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
Groups Settings API 会更新并检索现有 Google 群组的设置。通过该 API，您可以执行以下操作：
- 修改群组的内部和外部群组访问权限设置。
- 修改群组的通知。
- 配置讨论归档和消息审核。
- 自定义您账号的用户群组。
如需了解使用 Google 群组或管理其他类型的群组的更多方法，请参阅 Cloud Identity 文档。
Groups Settings API 数据模型
Groups Settings API 对 Groups 资源进行操作，该资源表示账号中的用户如何与其他用户群组进行沟通和协作。每个群组都由群组的电子邮件地址标识。
API 数据模型基于账号群组的 Groups 集合。每个组都有一组唯一的配置设置。
Groups Settings API 操作
您可以在 Groups Settings API 中调用群组设置方法，如以下表所述：
| 操作 |
说明 |
REST HTTP 映射 |
get |
获取客户账号的群组设置。所有 get 操作都必须由经过身份验证的用户授权。 |
对群组 URI 执行 GET。 |
update |
更新客户账号的群组设置。所有更新操作都必须由已通过身份验证的用户授权。 |
群组 URI 上的 PUT。 |
默认情况下，Groups Settings API 返回 JSON 格式的数据。Atom 表示法是另一种数据格式。JSON 和 Atom 数据格式都支持完整的读写功能。
JSON 是一种常见的互联网格式，可提供表示任意数据结构的方法。根据 json.org 的规定，JSON 是一种文本格式，完全独立于语言，但采用的是 C 系列语言（包括 C、C++、C#、Java、JavaScript、Perl 和 Python）编程人员熟悉的惯例。
如需更改 API 的数据格式，请在请求的 URI 中添加 alt 查询字符串，例如：
JSON
GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=json
Atom
GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=atom
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-08-29。
[null,null,["最后更新时间 (UTC)：2025-08-29。"],[],[],null,["# Groups Settings API overview\n\nThe Groups Settings API updates and retrieves settings for an existing\n[Google Group](https://support.google.com/a/topic/25838?&ref_topic=9197). Through\nthe API, you can do the following:\n\n- Modify a group's settings for internal and external group access.\n- Edit the group's notifications.\n- Configure discussion archiving and message moderation.\n- Customize your account's user groups.\n\nFor more ways to work with Google Groups, or manage other types of groups, see the\n[Cloud Identity documentation](https://cloud.google.com/identity/docs).\n\n### Groups Settings API data model\n\nThe Groups Settings API operates on a `Groups` resource which represents how users\nwithin an account communicate and collaborate with groups of other people. Each group is identified\nby the group's email address.\n\nThe API data model is based on the `Groups` collection of the account's groups. Each\ngroup has a unique set of configuration settings.\n\n### Groups Settings API operations\n\nYou can call group settings methods in the Groups Settings API, as described in the following\ntable:\n\n| Operation | Description | REST HTTP mappings |\n|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------|\n| `get` | Gets a group's settings for a customer's account. All get operations must be authorized by an [authenticated](/workspace/guides/auth-overview) user. | `GET` on a group URI. |\n| `update` | Updates a group's settings for a customer's account. All update operations must be authorized by an [authenticated](/workspace/guides/auth-overview) user. | `PUT` on a group URI. |\n\nJSON and Atom data formats\n--------------------------\n\nBy default, the Groups Settings API returns data in JSON format. The Atom notation is an alternate\ndata format. Both the JSON and Atom data formats support full read-write capabilities.\n\nJSON is a common\ninternet format that provides a method of representing arbitrary data structures. According to\n[json.org](http://www.json.org), JSON is a text format\nthat is completely language-independent but uses conventions that are familiar to programmers of\nthe C-family of languages, including C, C++, C#, Java, JavaScript, Perl, and Python.\n\n\u003cbr /\u003e\n\nTo change the API's data format, include the `alt` query string in your request's\nURI---for example:\n\n### JSON\n\n```\nGET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=json\n```\n\n### Atom\n\n```\nGET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=atom\n```"]]
