REST Resource: members

资源:成员

Google 群组成员可以是用户,也可以是其他群组。此成员可以是您账号网域中的成员,也可以是网域外的成员。如需详细了解常见的群组成员任务,请参阅开发者指南

JSON 表示法
{
  "kind": string,
  "email": string,
  "role": string,
  "etag": string,
  "type": string,
  "status": string,
  "delivery_settings": string,
  "id": string
}
字段
kind

string

API 资源的类型。对于成员资源,该值为 admin#directory#member

email

string

成员的电子邮件地址。成员可以是用户,也可以是其他群组。向群组添加成员时,此属性是必需的。email 必须是唯一的,并且不能是其他组的别名。如果电子邮件地址发生更改,API 会自动反映电子邮件地址更改。

role

string

成员在群组中的角色。对于群组成员资格周期,该 API 会返回错误。例如,如果 group1group2 的成员,则 group2 不能是 group1 的成员。如需详细了解成员的角色,请参阅向成员分配群组角色

可接受的值包括:

  • MANAGER:只有在使用管理控制台启用 Google 工作组后,此角色才可用。请参阅启用或停用群组企业版MANAGER 角色可以执行 OWNER 角色的所有操作,但无法将成员设为 OWNER 或删除群组。一个群组可以有多个 MANAGER 成员。
  • MEMBER:此角色可以订阅群组、查看讨论内容归档,以及查看群组的成员名单。如需详细了解成员角色,请参阅为成员分配群组角色
  • OWNER:此角色可以向群组发送消息、添加或移除成员、更改成员角色、更改群组设置以及删除群组。OWNER 必须是群组的成员。一个组可以有多个 OWNER
etag

string

资源的 ETag。

type

string

群组成员的类型。

可接受的值包括:

  • CUSTOMER:成员代表网域中的所有用户。系统不会返回电子邮件地址,返回的 ID 是客户 ID。
  • EXTERNAL:成员是网域外的用户或群组。(目前未使用)
  • GROUP:成员是另一个群组。
  • USER:成员是用户。
status

string

成员的状态(不可变)

delivery_settings

string

定义会员的邮件递送偏好设置。只有 insertupdateget 方法支持此字段。

可接受的值包括:

  • ALL_MAIL:所有消息,一到达即送达。
  • DAILY:每天最多发送一条消息。
  • DIGEST:最多将 25 条帖子的内容汇总到一封消息中。
  • DISABLED:移除订阅。
  • NONE:无消息。
id

string

群组成员的唯一 ID。成员 id 可用作成员请求 URI 的 memberKey

方法

delete

从群组中移除成员。

get

检索群组成员的属性。

hasMember

检查指定用户是否为群组成员。

insert

将用户添加到指定的群组。

list

检索群组中所有成员的分页列表。

patch

更新指定群组中用户的成员资格属性。

update

更新用户在指定群组中的成员资格。