Google Classroom API

จัดการชั้นเรียน บัญชีรายชื่อ และคำเชิญใน Google Classroom

บริการ: classroom.googleapis.com

หากต้องการเรียกใช้บริการนี้ เราขอแนะนำให้คุณใช้ไลบรารีของไคลเอ็นต์ที่ Google จัดหาให้ หากแอปพลิเคชันของคุณต้องใช้ไลบรารีของคุณเองเพื่อเรียกใช้บริการนี้ ให้ใช้ข้อมูลต่อไปนี้เมื่อส่งคำขอ API

เอกสารการค้นพบ

เอกสารการค้นพบเป็นข้อกำหนดที่เครื่องอ่านได้สำหรับการอธิบายและการใช้ REST API โดยใช้เพื่อสร้างไลบรารีของไคลเอ็นต์ ปลั๊กอิน IDE และเครื่องมืออื่นๆ ที่โต้ตอบกับ Google API บริการหนึ่งๆ อาจมีเอกสารการค้นพบหลายรายการ บริการนี้มีเอกสารการค้นพบต่อไปนี้

ปลายทางบริการ

ปลายทางบริการคือ URL ฐานที่ระบุที่อยู่เครือข่ายของบริการ API บริการหนึ่งๆ อาจมีปลายทางบริการหลายรายการ บริการนี้มีปลายทางของบริการต่อไปนี้ และ URI ทั้งหมดด้านล่างจะเกี่ยวข้องกับปลายทางของบริการนี้

  • https://classroom.googleapis.com

ทรัพยากร REST: v1.courses

เมธอด
checkAddOnCreationEligibility
(deprecated)		 GET /v1/courses/{courseId}:checkAddOnCreationEligibility
แสดงผลว่าผู้ใช้มีสิทธิ์สร้างไฟล์แนบของส่วนเสริมในหลักสูตรที่ระบุหรือไม่
checkGradingPeriodsSetupEligibility
(deprecated)		 GET /v1/courses/{courseId}:checkGradingPeriodsSetupEligibility
แสดงผลว่าผู้ใช้มีสิทธิ์อัปเดต GradingPeriodSettings ในหลักสูตรที่ระบุหรือไม่
create POST /v1/courses
สร้างหลักสูตร
delete DELETE /v1/courses/{id}
ลบหลักสูตร
get GET /v1/courses/{id}
แสดงผลหลักสูตร
getGradingPeriodSettings GET /v1/courses/{courseId}/gradingPeriodSettings
แสดงผลการตั้งค่าระยะเวลาการให้คะแนนในหลักสูตร
list GET /v1/courses
แสดงรายการหลักสูตรที่ผู้ใช้ที่ส่งคำขอได้รับอนุญาตให้ดู โดยจำกัดเฉพาะหลักสูตรที่ตรงกับคำขอ
patch PATCH /v1/courses/{id}
อัปเดตช่องอย่างน้อย 1 ช่องในหลักสูตร
update PUT /v1/courses/{id}
อัปเดตหลักสูตร
updateGradingPeriodSettings PATCH /v1/courses/{courseId}/gradingPeriodSettings
อัปเดตการตั้งค่าระยะเวลาการให้คะแนนของหลักสูตร

ทรัพยากร REST: v1.courses.aliases

เมธอด
create POST /v1/courses/{courseId}/aliases
สร้างชื่อแทนสำหรับหลักสูตร
delete DELETE /v1/courses/{courseId}/aliases/{alias}
ลบชื่อแทนของหลักสูตร
list GET /v1/courses/{courseId}/aliases
แสดงรายการชื่อแทนของหลักสูตร

ทรัพยากร REST: v1.courses.announcements

เมธอด
create POST /v1/courses/{courseId}/announcements
สร้างประกาศ
delete DELETE /v1/courses/{courseId}/announcements/{id}
ลบประกาศ
get GET /v1/courses/{courseId}/announcements/{id}
แสดงผลประกาศ
getAddOnContext GET /v1/courses/{courseId}/announcements/{itemId}/addOnContext
รับข้อมูลเมตาสำหรับส่วนเสริมของ Classroom ในบริบทของโพสต์ที่เฉพาะเจาะจง
list GET /v1/courses/{courseId}/announcements
แสดงรายการประกาศที่ผู้ขอได้รับอนุญาตให้ดู
modifyAssignees POST /v1/courses/{courseId}/announcements/{id}:modifyAssignees
แก้ไขโหมดและตัวเลือกผู้ได้รับมอบหมายของประกาศ
patch PATCH /v1/courses/{courseId}/announcements/{id}
อัปเดตช่องอย่างน้อย 1 ช่องของประกาศ

ทรัพยากร REST: v1.courses.announcements.addOnAttachments

เมธอด
create POST /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
สร้างไฟล์แนบของส่วนเสริมในโพสต์
delete DELETE /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}
ลบไฟล์แนบของส่วนเสริม
get GET /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}
แสดงผลไฟล์แนบของส่วนเสริม
list GET /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
แสดงผลไฟล์แนบทั้งหมดที่สร้างโดยส่วนเสริมในโพสต์
patch PATCH /v1/courses/{courseId}/announcements/{itemId}/addOnAttachments/{attachmentId}
อัปเดตไฟล์แนบของส่วนเสริม

ทรัพยากร REST: v1.courses.courseWork

เมธอด
create POST /v1/courses/{courseId}/courseWork
สร้างงานของชั้นเรียน
delete DELETE /v1/courses/{courseId}/courseWork/{id}
ลบงานของชั้นเรียน
get GET /v1/courses/{courseId}/courseWork/{id}
ส่งคืนงานของชั้นเรียน
getAddOnContext GET /v1/courses/{courseId}/courseWork/{itemId}/addOnContext
รับข้อมูลเมตาสำหรับส่วนเสริมของ Classroom ในบริบทของโพสต์ที่เฉพาะเจาะจง
list GET /v1/courses/{courseId}/courseWork
แสดงรายการงานของชั้นเรียนที่ผู้ขอได้รับอนุญาตให้ดู
modifyAssignees POST /v1/courses/{courseId}/courseWork/{id}:modifyAssignees
แก้ไขโหมดและตัวเลือกผู้ได้รับมอบหมายของงานของชั้นเรียน
patch PATCH /v1/courses/{courseId}/courseWork/{id}
อัปเดตช่องอย่างน้อย 1 ช่องของงานของชั้นเรียน

ทรัพยากร REST: v1.courses.courseWork.addOnAttachments

เมธอด
create POST /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments
สร้างไฟล์แนบของส่วนเสริมในโพสต์
delete DELETE /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
ลบไฟล์แนบของส่วนเสริม
get GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
แสดงผลไฟล์แนบของส่วนเสริม
list GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments
แสดงผลไฟล์แนบทั้งหมดที่สร้างโดยส่วนเสริมในโพสต์
patch PATCH /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}
อัปเดตไฟล์แนบของส่วนเสริม

ทรัพยากร REST: v1.courses.courseWork.addOnAttachments.studentSubmissions

เมธอด
get GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
ส่งคืนงานที่นักเรียนส่งสำหรับไฟล์แนบของส่วนเสริม
list GET /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions
แสดงรายการงานที่นักเรียนส่งซึ่งผู้ขอได้รับอนุญาตให้ดู
patch PATCH /v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
อัปเดตข้อมูลที่เชื่อมโยงกับงานในไฟล์แนบของส่วนเสริม

ทรัพยากร REST: v1.courses.courseWork.rubrics

เมธอด
create POST /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics
สร้างเกณฑ์การให้คะแนน
delete DELETE /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
ลบเกณฑ์การให้คะแนน
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
แสดงผลเกณฑ์การให้คะแนน
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics
แสดงรายการเกณฑ์การให้คะแนนที่ผู้ขอได้รับอนุญาตให้ดู
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}
อัปเดตเกณฑ์การให้คะแนน

ทรัพยากร REST: v1.courses.courseWork.studentSubmissions

เมธอด
get GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
ส่งคืนงานที่นักเรียนส่งมา
list GET /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
แสดงรายการงานที่นักเรียนส่งซึ่งผู้ขอได้รับอนุญาตให้ดู โดยพิจารณาจากขอบเขต OAuth ของคำขอ
modifyAttachments POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments
แก้ไขไฟล์แนบของงานที่นักเรียน/นักศึกษาส่ง
patch PATCH /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}
อัปเดตช่องอย่างน้อย 1 ช่องของงานที่นักเรียนส่ง
reclaim POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim
อ้างสิทธิ์งานที่นักเรียนส่งในนามของนักเรียนที่เป็นเจ้าของงาน
return POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return
ส่งคืนงานที่นักเรียนส่งมา
turnIn POST /v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:turnIn
ส่งงานของนักเรียน/นักศึกษา

ทรัพยากร REST: v1.courses.courseWorkMaterials

เมธอด
create POST /v1/courses/{courseId}/courseWorkMaterials
สร้างสื่อการเรียนการสอนของชั้นเรียน
delete DELETE /v1/courses/{courseId}/courseWorkMaterials/{id}
ลบสื่อการสอนของงานของชั้นเรียน
get GET /v1/courses/{courseId}/courseWorkMaterials/{id}
แสดงผลสื่อการสอนของงานของชั้นเรียน
getAddOnContext GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnContext
รับข้อมูลเมตาสำหรับส่วนเสริมของ Classroom ในบริบทของโพสต์ที่เฉพาะเจาะจง
list GET /v1/courses/{courseId}/courseWorkMaterials
แสดงรายการสื่อการเรียนการสอนของงานของชั้นเรียนที่ผู้ขอได้รับอนุญาตให้ดู
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{id}
อัปเดตช่องอย่างน้อย 1 ช่องของสื่อประกอบการเรียนการสอนของชั้นเรียน

ทรัพยากร REST: v1.courses.courseWorkMaterials.addOnAttachments

เมธอด
create POST /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
สร้างไฟล์แนบของส่วนเสริมในโพสต์
delete DELETE /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
ลบไฟล์แนบของส่วนเสริม
get GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
แสดงผลไฟล์แนบของส่วนเสริม
list GET /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
แสดงผลไฟล์แนบทั้งหมดที่สร้างโดยส่วนเสริมในโพสต์
patch PATCH /v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments/{attachmentId}
อัปเดตไฟล์แนบของส่วนเสริม

ทรัพยากร REST: v1.courses.posts

เมธอด
getAddOnContext GET /v1/courses/{courseId}/posts/{postId}/addOnContext
รับข้อมูลเมตาสำหรับส่วนเสริมของ Classroom ในบริบทของโพสต์ที่เฉพาะเจาะจง

ทรัพยากร REST: v1.courses.posts.addOnAttachments

เมธอด
create POST /v1/courses/{courseId}/posts/{postId}/addOnAttachments
สร้างไฟล์แนบของส่วนเสริมในโพสต์
delete DELETE /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}
ลบไฟล์แนบของส่วนเสริม
get GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}
แสดงผลไฟล์แนบของส่วนเสริม
list GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments
แสดงผลไฟล์แนบทั้งหมดที่สร้างโดยส่วนเสริมในโพสต์
patch PATCH /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}
อัปเดตไฟล์แนบของส่วนเสริม

ทรัพยากร REST: v1.courses.posts.addOnAttachments.studentSubmissions

เมธอด
get GET /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
ส่งคืนงานที่นักเรียนส่งสำหรับไฟล์แนบของส่วนเสริม
patch PATCH /v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
อัปเดตข้อมูลที่เชื่อมโยงกับงานในไฟล์แนบของส่วนเสริม

ทรัพยากร REST: v1.courses.studentGroups

เมธอด
create POST /v1/courses/{courseId}/studentGroups
สร้างกลุ่มนักเรียนสำหรับหลักสูตร
delete DELETE /v1/courses/{courseId}/studentGroups/{id}
ลบกลุ่มนักเรียน
list GET /v1/courses/{courseId}/studentGroups
แสดงรายการกลุ่มในหลักสูตร
patch PATCH /v1/courses/{courseId}/studentGroups/{id}
อัปเดตช่องอย่างน้อย 1 ช่องในกลุ่มนักเรียน/นักศึกษา

ทรัพยากร REST: v1.courses.studentGroups.studentGroupMembers

เมธอด
create POST /v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers
สร้างสมาชิกกลุ่มนักเรียนสำหรับกลุ่มนักเรียน
delete DELETE /v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers/{userId}
ลบสมาชิกกลุ่มนักเรียน
list GET /v1/courses/{courseId}/studentGroups/{studentGroupId}/studentGroupMembers
แสดงรายชื่อนักเรียนในกลุ่ม

ทรัพยากร REST: v1.courses.students

เมธอด
create POST /v1/courses/{courseId}/students
เพิ่มผู้ใช้เป็นนักเรียน/นักศึกษาของหลักสูตร
delete DELETE /v1/courses/{courseId}/students/{userId}
ลบนักเรียนออกจากหลักสูตร
get GET /v1/courses/{courseId}/students/{userId}
แสดงผลนักเรียนของหลักสูตร
list GET /v1/courses/{courseId}/students
แสดงรายชื่อนักเรียนของหลักสูตรนี้ที่ผู้ขอได้รับอนุญาตให้ดู

ทรัพยากร REST: v1.courses.teachers

เมธอด
create POST /v1/courses/{courseId}/teachers
สร้างครูของหลักสูตร
delete DELETE /v1/courses/{courseId}/teachers/{userId}
นำครูที่ระบุออกจากหลักสูตรที่ระบุ
get GET /v1/courses/{courseId}/teachers/{userId}
แสดงผลครูของหลักสูตร
list GET /v1/courses/{courseId}/teachers
แสดงรายชื่อครูของหลักสูตรนี้ที่ผู้ขอได้รับอนุญาตให้ดู

ทรัพยากร REST: v1.courses.topics

เมธอด
create POST /v1/courses/{courseId}/topics
สร้างหัวข้อ
delete DELETE /v1/courses/{courseId}/topics/{id}
ลบหัวข้อ
get GET /v1/courses/{courseId}/topics/{id}
แสดงผลหัวข้อ
list GET /v1/courses/{courseId}/topics
แสดงรายการหัวข้อที่ผู้ขอได้รับอนุญาตให้ดู
patch PATCH /v1/courses/{courseId}/topics/{id}
อัปเดตช่องอย่างน้อย 1 ช่องของหัวข้อ

ทรัพยากร REST: v1.invitations

เมธอด
accept POST /v1/invitations/{id}:accept
ยอมรับคำเชิญ นำคำเชิญออก และเพิ่มผู้ใช้ที่ได้รับเชิญเป็นครูหรือนักเรียน (ตามความเหมาะสม) ของหลักสูตรที่ระบุ
create POST /v1/invitations
สร้างคำเชิญ
delete DELETE /v1/invitations/{id}
ลบคำเชิญ
get GET /v1/invitations/{id}
แสดงผลคำเชิญ
list GET /v1/invitations
แสดงรายการคำเชิญที่ผู้ใช้ที่ส่งคำขอได้รับอนุญาตให้ดู โดยจำกัดเฉพาะคำเชิญที่ตรงกับคำขอรายการ

ทรัพยากร REST: v1.registrations

เมธอด
create POST /v1/registrations
สร้าง Registration ซึ่งทำให้ Classroom เริ่มส่งการแจ้งเตือนจาก feed ที่ระบุไปยังปลายทางที่ระบุใน cloudPubSubTopic
delete DELETE /v1/registrations/{registrationId}
ลบ Registration ซึ่งทำให้ Classroom หยุดส่งการแจ้งเตือนสำหรับ Registration นั้น

ทรัพยากร REST: v1.userProfiles

เมธอด
checkUserCapability GET /v1/userProfiles/{userId}:checkUserCapability
แสดงผลว่าผู้ใช้สามารถใช้ความสามารถของ Classroom ที่ระบุได้หรือไม่
get GET /v1/userProfiles/{userId}
แสดงโปรไฟล์ผู้ใช้

ทรัพยากร REST: v1.userProfiles.guardianInvitations

เมธอด
create POST /v1/userProfiles/{guardianInvitation.studentId}/guardianInvitations
สร้างคำเชิญผู้ปกครอง และส่งอีเมลถึงผู้ปกครองเพื่อขอให้ยืนยันว่าเป็นผู้ปกครองของนักเรียน/นักศึกษา
get GET /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
แสดงผลคำเชิญผู้ปกครองที่เฉพาะเจาะจง
list GET /v1/userProfiles/{studentId}/guardianInvitations
แสดงรายการคำเชิญผู้ปกครองที่ผู้ใช้ที่ส่งคำขอได้รับอนุญาตให้ดู โดยกรองตามพารามิเตอร์ที่ระบุ
patch PATCH /v1/userProfiles/{studentId}/guardianInvitations/{invitationId}
แก้ไขคำเชิญผู้ปกครอง

ทรัพยากร REST: v1.userProfiles.guardians

เมธอด
delete DELETE /v1/userProfiles/{studentId}/guardians/{guardianId}
ลบผู้ปกครอง
get GET /v1/userProfiles/{studentId}/guardians/{guardianId}
แสดงผลผู้ปกครองที่เฉพาะเจาะจง
list GET /v1/userProfiles/{studentId}/guardians
แสดงรายการผู้ปกครองที่ผู้ใช้ที่ส่งคำขอได้รับอนุญาตให้ดู โดยจำกัดเฉพาะผู้ปกครองที่ตรงกับคำขอ