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 。 |
JSON 和 Atom 数据格式
默认情况下,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