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 会返回错误。例如，如果 group1 是 group2 的成员，则 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

定义会员的邮件递送偏好设置。只有 insert、update 和 get 方法支持此字段。

可接受的值包括：

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

string

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

方法

delete

 从群组中移除成员。

get

 检索群组成员的属性。

hasMember

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

insert

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

list

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

patch

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

update

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