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