Method: courses.courseWork.create

สร้างงานในหลักสูตร

งานในหลักสูตรที่สร้างขึ้น (และงานที่นักเรียนส่งที่เกี่ยวข้อง) จะเชื่อมโยงกับโปรเจ็กต์ Developer Console ของรหัสไคลเอ็นต์ OAuth ที่ใช้ส่งคำขอ คำขอ Classroom API เพื่อแก้ไขงานในชั้นเรียนและงานที่นักเรียนส่งต้องส่งด้วยรหัสไคลเอ็นต์ OAuth จากโปรเจ็กต์ Developer Console ที่เชื่อมโยง

วิธีการนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้

  • PERMISSION_DENIED หากผู้ใช้ที่ส่งคำขอไม่ได้รับอนุญาตให้เข้าถึงหลักสูตรที่ขอ สร้างงานในหลักสูตรที่ขอ แชร์ไฟล์แนบในไดรฟ์ หรือมีข้อผิดพลาดในการเข้าถึง
  • INVALID_ARGUMENT หากคำขอมีรูปแบบไม่ถูกต้อง
  • NOT_FOUND หากไม่มีหลักสูตรที่ขอ
  • FAILED_PRECONDITION สำหรับข้อผิดพลาดเกี่ยวกับคำขอต่อไปนี้
    • AttachmentNotVisible

คำขอ HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
courseId

string

ตัวระบุของหลักสูตร ตัวระบุนี้อาจเป็นตัวระบุที่ Classroom กำหนดหรือ alias ก็ได้

พารามิเตอร์การค้นหา

พารามิเตอร์
previewVersion

enum (PreviewVersion)

ไม่บังคับ เวอร์ชันตัวอย่างของอุปกรณ์ปลายทาง คุณต้องตั้งค่านี้เพื่อเข้าถึงความสามารถใหม่ๆ ของ API ที่พร้อมให้บริการแก่นักพัฒนาแอปในโปรแกรมเวอร์ชันตัวอย่าง

เนื้อความของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ CourseWork

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ CourseWork ที่สร้างขึ้นใหม่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/classroom.coursework.students

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์