Method: userProfiles.guardianInvitations.get

แสดงคำเชิญผู้ปกครองที่เฉพาะเจาะจง

วิธีการนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

  • PERMISSION_DENIED หากผู้ใช้ที่ส่งคำขอไม่ได้รับอนุญาตให้ดูคำเชิญผู้ปกครองสำหรับนักเรียนที่ระบุด้วย studentId, หากไม่ได้เปิดใช้ผู้ปกครองสำหรับโดเมนที่เป็นปัญหา หรือหากเกิดข้อผิดพลาดในการเข้าถึงอื่นๆ
  • INVALID_ARGUMENT หากระบุ studentId แต่ระบบไม่รู้จักรูปแบบ (ไม่ใช่อีเมล, studentId จาก API หรือสตริงที่เป็นตัวอักษรล้วน me)
  • NOT_FOUND หาก Classroom ไม่พบบันทึกของนักเรียนหรือ invitationId ดังกล่าว ระบบอาจแสดงผลหากมีนักเรียน แต่ผู้ใช้ที่ส่งคำขอไม่มีสิทธิ์ดูนักเรียนคนนั้น

คำขอ HTTP

GET https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardianInvitations/{invitationId}

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
studentId

string

รหัสของนักเรียนที่ส่งคำขอเชิญผู้ปกครอง
invitationId

string

ช่อง id ของ GuardianInvitation ที่ขอ

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ GuardianInvitation

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
  • https://www.googleapis.com/auth/classroom.guardianlinks.students

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์