返回特定监护人。
此方法会返回以下错误代码:
- 如果请求的用户看不到任何与所提供的
studentId
相匹配的用户、请求的用户不能查看studentId
标识的学生的监护人信息、相关网域没有监护人,或者出现其他访问错误,则为PERMISSION_DENIED
。 INVALID_ARGUMENT
如果已指定studentId
,但系统无法识别其格式(它不是电子邮件地址、API 中的studentId
和字面量字符串me
)。- 如果发出请求的用户可以查看所请求的
studentId
的监护人,但该学生没有与所提供的guardianId
匹配的Guardian
记录,则返回NOT_FOUND
。
HTTP 请求
GET https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardians/{guardianId}
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
studentId |
正在请求监护人的学生。如下所示:
|
guardianId |
|
请求正文
请求正文必须为空。
响应正文
如果成功,响应正文将包含一个 Guardian
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
https://www.googleapis.com/auth/classroom.guardianlinks.students
有关详情,请参阅 OAuth 2.0 概览。