นักเรียนและครูเป็นการจับคู่ที่เจาะจงระหว่างโปรไฟล์ผู้ใช้กับหลักสูตร ซึ่งแสดงถึงบทบาทของผู้ใช้ดังกล่าวในหลักสูตร การระบุสถานะนักเรียนและครูไม่ใช่การกำหนดทั่วโลก แต่จะมอบหมายให้ผู้ใช้เป็นครูของหลักสูตรหนึ่งและนักเรียนในอีกหลักสูตรได้ การระบุสถานะเป็น "นักเรียน" หรือ "ครู" แสดงถึงชุดสิทธิ์สำหรับผู้ใช้รายหนึ่งๆ ในหลักสูตรหนึ่งๆ
- นักเรียน/นักศึกษา
- ทรัพยากรสำหรับนักเรียนจะแสดงถึงผู้ใช้ที่ลงทะเบียนเป็นนักเรียนในหลักสูตรหนึ่งๆ นักเรียนจะดูรายละเอียดหลักสูตรและครูของหลักสูตรนั้นได้
- ครู
- แหล่งข้อมูลสำหรับครูแสดงถึงผู้ใช้ที่สอนหลักสูตรหนึ่งๆ ครูมีสิทธิ์ดูและเปลี่ยนแปลงรายละเอียดของหลักสูตร ดูครูและนักเรียน รวมทั้งจัดการครูและนักเรียนคนอื่นๆ ได้
ระบบจะระบุนักเรียนและครูโดยใช้รหัสที่ไม่ซ้ำกันหรืออีเมลของผู้ใช้ตามที่แสดงโดย 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
ที่ตรงกัน
จัดการเจ้าของหลักสูตร
ผู้ดูแลระบบโดเมนสามารถโอนการเป็นเจ้าของหลักสูตรระหว่างครูได้ โปรดดูรายละเอียดสำคัญในส่วนโอนการเป็นเจ้าของหลักสูตร