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 Groups for Business 时才可用。请参阅启用或停用群组企业版。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

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