- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ลองใช้งาน
ส่งกลับรายการคำเชิญผู้ปกครองที่ผู้ใช้ที่ส่งคำขอมีสิทธิ์ดู โดยกรองตามพารามิเตอร์ที่ระบุ
เมธอดนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้
PERMISSION_DENIED
หากระบุstudentId
ไว้ และผู้ใช้ที่ส่งคำขอไม่ได้รับอนุญาตให้ดูคำเชิญผู้ปกครองของนักเรียนรายดังกล่าว หากระบุ"-"
เป็นstudentId
และผู้ใช้ไม่ใช่ผู้ดูแลระบบโดเมน ไม่ได้เปิดใช้ผู้ปกครองในโดเมนที่เป็นปัญหา หรือเนื่องจากข้อผิดพลาดในการเข้าถึงอื่นๆINVALID_ARGUMENT
หากระบุstudentId
แต่ระบบไม่รู้จักรูปแบบ (ไม่ใช่อีเมล หรือstudentId
จาก API หรือสตริงตามตัวอักษรme
) ระบบอาจแสดงผลหากระบุpageToken
หรือstate
ไม่ถูกต้องNOT_FOUND
หากระบุstudentId
ไว้และจดจำรูปแบบได้ แต่ Classroom ไม่มีบันทึกของนักเรียนคนนั้น
คำขอ HTTP
GET https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardianInvitations
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
studentId |
บัตรประจำตัวของนักเรียนที่ระบบจะส่งคืนคำเชิญเป็นผู้ปกครอง ตัวระบุอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้
|
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
invitedEmailAddress |
หากระบุไว้ ระบบจะแสดงผลเฉพาะผลลัพธ์ที่มี |
states[] |
หากระบุไว้ ระบบจะแสดงผลเฉพาะผลลัพธ์ที่มีค่า |
pageToken |
แสดงค่า คำขอ |
pageSize |
จำนวนรายการสูงสุดที่จะแสดง 0 หรือไม่ได้ระบุ ระบุว่าเซิร์ฟเวอร์อาจกำหนดค่าสูงสุด เซิร์ฟเวอร์อาจแสดงผลลัพธ์น้อยกว่าจำนวนที่ระบุ |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
ตอบกลับเมื่อมีการแสดงคำเชิญผู้ปกครอง
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"guardianInvitations": [
{
object ( |
ช่อง | |
---|---|
guardianInvitations[] |
คำเชิญผู้ปกครองที่ตรงกับคำขอในรายการ |
nextPageToken |
โทเค็นที่ระบุหน้าถัดไปของผลการค้นหาที่จะแสดง หากเว้นว่างไว้ จะไม่มีผลลัพธ์เพิ่มเติม |
ขอบเขตการให้สิทธิ์
ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
https://www.googleapis.com/auth/classroom.guardianlinks.students
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์