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