REST Resource: groups

资源：群组

Google 群组可让您的用户使用群组的电子邮件地址向一群人发送邮件。如需详细了解常见任务，请参阅开发者指南。

如需了解其他类型的群组，请参阅 Cloud Identity Groups API 文档。

注意：调用此 API 的用户（或被服务账号模拟的用户）必须拥有包含 Admin API 群组权限的已分配角色，例如超级用户或群组管理员。

JSON 表示法 
{
  "id": string,
  "email": string,
  "name": string,
  "description": string,
  "adminCreated": boolean,
  "directMembersCount": string,
  "kind": string,
  "etag": string,
  "aliases": [
    string
  ],
  "nonEditableAliases": [
    string
  ]
}
字段
id

string

只读。群组的唯一 ID。群组 id 可用作群组请求 URI 的 groupKey。
email

string

群组的电子邮件地址。如果您的账号有多个域名，请为电子邮件地址选择合适的域名。email 必须是唯一的。创建组时必须提供此属性。群组电子邮件地址与用户名需遵守相同的字符使用规则，详情请参阅帮助中心。
name

string

群组的显示名称。
description

string

用于帮助用户确定群组用途的扩展说明。例如，您可以添加以下信息：谁应加入该群组、向该群组发送哪些类型的邮件、该群组常见问题解答的链接或相关群组。长度上限为 4,096 个字符。
adminCreated

boolean

只读。如果此群组由管理员（而非用户）创建，则值为 true。
directMembersCount

string (int64 format)

直接成为该群组的成员的用户数量。如果某个群组是此群组（上级群组）的成员（下级群组），则下级群组的成员不会计入上级群组的 directMembersCount 属性。
kind

string

API 资源的类型。对于群组资源，值为 admin#directory#group。
etag

string

资源的 ETag。
aliases[]

string

只读。群组的别名电子邮件地址列表。如需添加、更新或移除群组的别名，请使用 groups.aliases 方法。如果在群组的 POST 或 PUT 请求中进行修改，则该修改会被忽略。
nonEditableAliases[]

string

只读。账号主域名或子域名以外的群组别名电子邮件地址列表，该列表无法修改。这些是群组使用的有效电子邮件地址。这是群组的 API 响应中返回的只读属性。如果在群组的 POST 或 PUT 请求中进行修改，则该修改会被忽略。

方法

delete

 删除群组。

get

 检索组的属性。

insert

 创建群组。

list

 检索给定 userKey 的域或用户的所有群组（已分页）。

patch

 更新组的属性。

update

 更新组的属性。