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}
ส่งคืนงานที่นักเรียนส่งมาสำหรับไฟล์แนบเสริม
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
แสดงรายการผู้ปกครองที่ผู้ใช้ที่ขอมีสิทธิ์ดู โดยจำกัดเฉพาะผู้ปกครองที่ตรงกับคำขอ