นักเรียนและครูเป็นการแมปที่เฉพาะเจาะจงระหว่างโปรไฟล์ผู้ใช้กับหลักสูตร ซึ่งแสดงถึงบทบาทของผู้ใช้ในหลักสูตร การกำหนดสถานะนักเรียนและครูจะไม่มีผลกับทุกชั้นเรียน ผู้ใช้อาจได้รับมอบหมายให้เป็นครูในชั้นเรียนหนึ่งและนักเรียนในอีกชั้นเรียนหนึ่ง การกำหนด "นักเรียน" หรือ "ครู" แสดงถึงชุดสิทธิ์สำหรับผู้ใช้รายหนึ่งในหลักสูตรหนึ่งๆ
- นักเรียน/นักศึกษา
- ทรัพยากรนักเรียนแสดงถึงผู้ใช้ที่ลงทะเบียนเป็นนักเรียนในหลักสูตรที่เฉพาะเจาะจง นักเรียนมีสิทธิ์ดูรายละเอียดหลักสูตรและครูของหลักสูตรนั้น
- ครู
- ทรัพยากรครูแสดงถึงผู้ใช้ที่สอนหลักสูตรหนึ่งๆ ครูได้รับอนุญาตให้ดูและเปลี่ยนแปลงรายละเอียดหลักสูตร ดูครูและนักเรียน รวมถึงจัดการครูและนักเรียนคนอื่นๆ
นักเรียนและครูจะระบุด้วยรหัสที่ไม่ซ้ำกันหรืออีเมลของผู้ใช้ตามที่ Directory API แสดง
ผู้ใช้ปัจจุบันยังอ้างอิงรหัสของตนเองได้โดยใช้ตัวย่อ "me"
การเพิ่มโดยตรง
ผู้ดูแลระบบโดเมนได้รับอนุญาตให้ข้ามขั้นตอนการเชิญและเพิ่มผู้ใช้ภายในโดเมนของตนเป็นครูหรือนักเรียนในหลักสูตรภายในโดเมนได้โดยตรง ระบบจะถือว่าหลักสูตรอยู่ในโดเมนของผู้ดูแลระบบหากเจ้าของหลักสูตรอยู่ในโดเมนของผู้ดูแลระบบ สำหรับผู้ใช้หรือหลักสูตรที่อยู่นอกโดเมนของผู้ดูแลระบบโดเมนที่ตรวจสอบสิทธิ์แล้ว แอปพลิเคชันต้องได้รับความยินยอมจากผู้ใช้โดยการส่งคำเชิญด้วยวิธีการ invitations.create()
เพิ่มหรือนำครูออก
ผู้ดูแลระบบโดเมนสามารถเพิ่มครูภายในโดเมนของตนลงในหลักสูตรได้โดยตรงด้วย teachers.create()
ดังที่แสดงในตัวอย่างต่อไปนี้
.NET
Java
PHP
Python
หากจะเพิ่มครูคนอื่นๆ ในนามของครูที่ผ่านการตรวจสอบสิทธิ์ คุณต้องใช้วิธีการ invitations.create()
คุณนำครูคนอื่นๆ ออกจากหลักสูตรได้โดยใช้วิธี teachers.delete()
การดำเนินการนี้จะนําผู้สอนที่ระบุออกจากหลักสูตรเท่านั้น และไม่ส่งผลต่อการกำหนดผู้สอนให้สอนหลักสูตรอื่นๆ หรือโปรไฟล์ผู้ใช้
ลงทะเบียนหรือนำนักเรียนออก
ผู้ดูแลระบบโดเมนสามารถเพิ่มนักเรียนภายในโดเมนได้โดยตรงด้วยวิธี students.create()
ดังที่แสดงในตัวอย่างต่อไปนี้
.NET
Java
PHP
Python
หากเพิ่มนักเรียนในนามของครูที่ตรวจสอบสิทธิ์แล้ว คุณต้องใช้วิธีการ invitations.create()
คุณนำนักเรียนออกจากหลักสูตรได้โดยใช้วิธี students.delete()
การดำเนินการนี้จะนําเฉพาะนักศึกษาที่ระบุออกจากหลักสูตรเท่านั้น และจะไม่ส่งผลต่อการลงทะเบียนในหลักสูตรอื่นๆ หรือโปรไฟล์ผู้ใช้
เรียกข้อมูลหลักสูตรของผู้ใช้
หากต้องการเรียกข้อมูลรายชื่อหลักสูตรสำหรับนักเรียนหรือครู ให้เรียกใช้ courses.list()
แล้วป้อน studentId
หรือ teacherId
ของผู้ใช้ที่เกี่ยวข้อง
เรียกข้อมูลโปรไฟล์ของผู้ใช้
หากต้องการเรียกข้อมูลโปรไฟล์แบบย่อของผู้ใช้ ซึ่งรวมถึงรหัสและชื่อ ให้เรียกใช้ userProfiles.get()
พร้อมรหัส อีเมล หรือ "ฉัน" ของผู้ใช้ที่ขอ
หากต้องการดึงข้อมูลช่อง emailAddress
คุณต้องใส่ขอบเขต classroom.profile.emails
รหัสที่แสดงผลจะสอดคล้องกับทรัพยากรผู้ใช้ Directory API ที่มี studentId
หรือ teacherId
ที่ตรงกัน
จัดการเจ้าของหลักสูตร
ผู้ดูแลระบบโดเมนจะโอนการเป็นเจ้าของหลักสูตรระหว่างครูได้ โปรดดูรายละเอียดสำคัญในส่วนโอนความเป็นเจ้าของหลักสูตร