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 操作。

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