REST Resource: spaces.members

资源：Membership

表示 Google Chat 中的成员关系，例如用户或 Chat 应用是否受邀加入聊天室、是否是聊天室成员或是否不在聊天室中。

JSON 表示法 
{
  "name": string,
  "state": enum (MembershipState),
  "role": enum (MembershipRole),
  "createTime": string,
  "deleteTime": string,

  // Union field memberType can be only one of the following:
  "member": {
    object (User)
  },
  "groupMember": {
    object (Group)
  }
  // End of list of possible types for union field memberType.
}
字段
name

string

标识符。由服务器分配的成员资源名称。

格式：spaces/{space}/members/{member}
state

enum (MembershipState)

仅限输出。会员资格的状态。
role

enum (MembershipRole)

可选。用户在 Chat 聊天室中的角色，该角色决定了用户在聊天室中可以执行的操作。

此字段只能用作 members.patch 中的输入。
createTime

string (Timestamp format)

可选。不可变。成员资格的创建时间，例如成员加入聊天室或受邀加入聊天室的时间。此字段仅用于输出，但在导入模式聊天室中用于导入历史会员资格时除外。
deleteTime

string (Timestamp format)

可选。不可变。成员资格的删除时间，例如成员退出或被移除聊天室的时间。此字段仅输出，除非用于在导入模式聊天室中导入历史成员。
联合字段 memberType。与此会员资格关联的成员。未来可能会支持其他成员类型。memberType 只能是下列其中一项：
member

object (User)

可选。成员资格对应的 Google Chat 用户或应用。如果您的 Chat 应用以用户的身份进行身份验证，输出中会填充用户 name 和 type。
groupMember

object (Group)

可选。相应成员资格对应的 Google 群组。

如需读取或更改 Google 群组的成员资格，您需要进行用户身份验证。

MembershipState

指定成员与聊天室的关系。我们将来可能会支持其他会员状态。

枚举
MEMBERSHIP_STATE_UNSPECIFIED 默认值。请勿使用。
JOINED 系统会将用户添加到聊天室，并且用户可以参与聊天室。
INVITED 用户受邀加入聊天室，但尚未加入。
NOT_A_MEMBER 此用户不是聊天室的成员，也没有加入聊天室的待处理邀请。

MembershipRole

表示用户在 Chat 聊天室中被允许执行的操作。未来可能会添加更多枚举值。

枚举
MEMBERSHIP_ROLE_UNSPECIFIED 默认值。对于 users：他们不是聊天室成员，但可以受邀加入。对于 Google Groups：系统始终会为这些节点分配此角色（将来可能会使用其他枚举值）。
ROLE_MEMBER 聊天室成员。用户拥有基本权限，例如向聊天室发送消息。在 1 对 1 和未命名的群组对话中，每个人都拥有此角色。
ROLE_MANAGER 聊天室管理员。该用户拥有所有基本权限以及管理权限，可以管理聊天室，例如添加或移除成员。仅在 SpaceType.SPACE 中受支持。

群组

Google Chat 中的 Google 群组。

JSON 表示法 
{
  "name": string
}
字段
name

string

Google 群组的资源名称。

表示 Cloud Identity Groups API 中的一个群组。

格式：groups/{group}

方法

create

 为发起通话的 Chat 应用、用户或 Google 群组创建会员资格。

delete

 删除一个成员资格。

get

 返回有关成员资格的详细信息。

list

 列出聊天室中的成员。

patch

 更新成员资格。