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)。 |
update |
更新客户账号的群组设置。所有更新操作都必须由已通过身份验证的用户授权。 | PUT(针对群组 URI)。 |
JSON 和 Atom 数据格式
默认情况下,Groups Settings API 以 JSON 格式返回数据。Atom 注释是一种替代数据格式。JSON 和 Atom 数据格式均支持完整的读写功能。
JSON 是一种常见的互联网格式,可用于表示任意数据结构。根据 json.org 的说法,JSON 是一种完全独立于语言的文本格式,但它使用的约定对于 C 系列语言(包括 C、C++、C#、Java、JavaScript、Perl 和 Python)的程序员来说非常熟悉。
您可以在请求的 URI 中添加 alt 查询字符串,以更改 API 的数据格式。例如:
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