检查指定用户是否为群组成员。成员资格可以是直接的,也可以是嵌套的,但如果是嵌套的,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 中 Has Member 响应的 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
如需了解详情,请参阅授权指南。