检查指定用户是否为群组成员。成员资格可以是直接的,也可以是嵌套的,但如果嵌套,memberKey
和 groupKey
必须是同一网域中的实体,否则系统会返回 Invalid input
错误。如需检查嵌套成员资格是否包含群组网域外的实体,请使用 Cloud Identity Groups API 中的 checkTransitiveMembership()
方法。
HTTP 请求
GET https://admin.googleapis.com/admin/directory/v1/groups/{groupKey}/hasMember/{memberKey}
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
groupKey |
标识 API 请求中的组。此值可以是群组的电子邮件地址、群组别名或唯一的群组 ID。 |
memberKey |
标识 API 请求中的用户成员。该值可以是用户的主电子邮件地址、别名或唯一 ID。 |
请求正文
请求正文必须为空。
响应正文
Directory API 中“拥有成员”响应的 JSON 模板。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "isMember": boolean } |
字段 | |
---|---|
isMember |
仅限输出。标识指定用户是否为群组成员。成员资格可以是直接的,也可以是嵌套的。 |
授权范围
需要以下 OAuth 范围之一:
https://apps-apis.google.com/a/feeds/groups/
https://www.googleapis.com/auth/admin.directory.group
https://www.googleapis.com/auth/admin.directory.group.member
https://www.googleapis.com/auth/admin.directory.group.member.readonly
https://www.googleapis.com/auth/admin.directory.group.readonly
有关详情,请参阅授权指南。