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