REST Resource: courses.courseWork

แหล่งข้อมูล: งานในหลักสูตร

งานในหลักสูตรที่ครูสร้างขึ้นสำหรับนักเรียนในหลักสูตร

การแสดง JSON
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
}
ช่อง
courseId

string

ตัวระบุของหลักสูตร

อ่านอย่างเดียว

id

string

ตัวระบุที่ Classroom กำหนดของงานในหลักสูตรนี้ ซึ่งจะไม่ซ้ำกันต่อหลักสูตร

อ่านอย่างเดียว

title

string

ชื่อของงานในหลักสูตรนี้ ชื่อต้องเป็นสตริง UTF-8 ที่ถูกต้องซึ่งมีอักขระระหว่าง 1 ถึง 3,000 ตัว

description

string

คำอธิบายเพิ่มเติมของงานของหลักสูตรนี้ หากมีการตั้งค่า คำอธิบายต้องเป็นสตริง UTF-8 ที่ถูกต้องและมีอักขระไม่เกิน 30,000 ตัว

materials[]

object (Material)

สื่อเพิ่มเติม

งานในหลักสูตรต้องมีรายการเนื้อหาไม่เกิน 20 รายการ

state

enum (CourseWorkState)

สถานะของงานในหลักสูตรนี้ หากไม่ระบุ สถานะเริ่มต้นจะเป็น DRAFT

creationTime

string (Timestamp format)

การประทับเวลาเมื่อสร้างงานของหลักสูตรนี้

อ่านอย่างเดียว

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

การประทับเวลาของการเปลี่ยนแปลงล่าสุดของงานในหลักสูตรนี้

อ่านอย่างเดียว

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

dueDate

object (Date)

วันที่ (UTC) ซึ่งไม่บังคับว่างานในหลักสูตรนี้ครบกำหนดส่ง คุณต้องระบุข้อมูลนี้หากระบุ dueTime

dueTime

object (TimeOfDay)

เวลาที่ไม่บังคับของวัน (UTC) ที่ระบุว่างานของหลักสูตรนี้ครบกำหนดส่ง คุณต้องระบุข้อมูลนี้หากระบุ dueDate

scheduledTime

string (Timestamp format)

การประทับเวลาที่ไม่บังคับเมื่อกำหนดเวลาเผยแพร่งานของหลักสูตรนี้

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

maxPoints

number

คะแนนสูงสุดสำหรับงานของหลักสูตรนี้ หาก 0 หรือไม่ได้ระบุ จะถือว่างานนี้ยังไม่ได้ให้คะแนน ค่านี้ต้องเป็นจำนวนเต็มที่ไม่ติดลบ

workType

enum (CourseWorkType)

ประเภทของงานในหลักสูตรนี้

ระบบจะตั้งค่าประเภทเมื่อมีการสร้างงานในหลักสูตรและไม่สามารถเปลี่ยนแปลงได้

associatedWithDeveloper

boolean

รายการงานในหลักสูตรนี้เชื่อมโยงกับโปรเจ็กต์ Developer Console ที่ส่งคำขอหรือไม่

ดูรายละเอียดเพิ่มเติมได้ที่ courseWork.create

อ่านอย่างเดียว

assigneeMode

enum (AssigneeMode)

โหมดผู้ได้รับมอบหมายของการบ้านและรายงาน หากไม่ได้ระบุ ค่าเริ่มต้นคือ ALL_STUDENTS

individualStudentsOptions

object (IndividualStudentsOptions)

ตัวระบุนักเรียนที่มีสิทธิ์เข้าถึงการบ้านและรายงาน ช่องนี้จะตั้งค่าก็ต่อเมื่อ assigneeMode เป็น INDIVIDUAL_STUDENTS หาก assigneeMode คือ INDIVIDUAL_STUDENTS ระบบจะมอบหมายการบ้านและรายงานเฉพาะนักเรียนที่ระบุในช่องนี้เท่านั้น

submissionModificationMode

enum (SubmissionModificationMode)

การตั้งค่าเพื่อกำหนดว่านักเรียนจะแก้ไขงานได้เมื่อใด หากไม่ได้ระบุ ค่าเริ่มต้นคือ MODIFIABLE_UNTIL_TURNED_IN

creatorUserId

string

ตัวระบุของผู้ใช้ที่สร้างการบ้านและรายงาน

อ่านอย่างเดียว

topicId

string

ตัวระบุหัวข้อที่เชื่อมโยงกับการบ้านและรายงานนี้ ต้องตรงกับหัวข้อที่มีอยู่ในหลักสูตร

gradeCategory

object (GradeCategory)

หมวดหมู่ที่เกี่ยวข้องกับคะแนนของการบ้านและรายงาน นำเสนอเมื่อมีการเลือกหมวดหมู่สำหรับการบ้านและรายงานเท่านั้น อาจใช้ในการคำนวณเกรดโดยรวม

อ่านอย่างเดียว

ฟิลด์การรวม details รายละเอียดเพิ่มเติมเฉพาะสำหรับงานประเภทใดประเภทหนึ่งในหลักสูตร details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
assignment

object (Assignment)

รายละเอียดงาน ช่องนี้จะป็อปปูเลตเมื่อ workType เป็นASSIGNMENTเท่านั้น

อ่านอย่างเดียว

multipleChoiceQuestion

object (MultipleChoiceQuestion)

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

CourseWorkState

สถานะของงานที่เป็นไปได้

Enum
COURSE_WORK_STATE_UNSPECIFIED ไม่มีการระบุรัฐ โดยจะไม่มีการคืนเงิน
PUBLISHED สถานะของงานที่เผยแพร่แล้ว นี่คือสถานะเริ่มต้น
DRAFT สถานะของงานที่ยังไม่ได้เผยแพร่ งานที่มีสถานะนี้จะปรากฏเฉพาะกับครูของหลักสูตรและผู้ดูแลระบบโดเมนเท่านั้น
DELETED สถานะของงานที่เผยแพร่แล้วแต่ลบไปแล้ว งานที่มีสถานะนี้จะปรากฏเฉพาะกับครูของหลักสูตรและผู้ดูแลระบบโดเมนเท่านั้น ระบบจะลบงานที่อยู่ในสถานะนี้หลังจากผ่านไประยะหนึ่ง

SubmissionModificationMode

โหมดการแก้ไขที่เป็นไปได้สำหรับงานที่นักเรียนส่ง

Enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED ไม่ได้ระบุโหมดการแก้ไข โดยจะไม่มีการคืนเงิน
MODIFIABLE_UNTIL_TURNED_IN แก้ไขสิ่งที่ส่งก่อนส่งได้
MODIFIABLE แก้ไขข้อมูลที่ส่งได้ทุกเมื่อ

การมอบหมาย

รายละเอียดเพิ่มเติมสำหรับงาน

การแสดง JSON
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
ช่อง
studentWorkFolder

object (DriveFolder)

โฟลเดอร์ไดรฟ์ที่มีไฟล์แนบจากงานที่นักเรียนส่ง ข้อมูลนี้มีไว้สำหรับครูและผู้ดูแลระบบของหลักสูตรเท่านั้น

MultipleChoiceQuestion

รายละเอียดเพิ่มเติมสำหรับคำถามแบบหลายตัวเลือก

การแสดง JSON
{
  "choices": [
    string
  ]
}
ช่อง
choices[]

string

ตัวเลือกที่เป็นไปได้

วิธีการ

create

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

delete

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

get

ส่งคืนงานของหลักสูตร

getAddOnContext

รับข้อมูลเมตาสำหรับส่วนเสริมของ Classroom ในบริบทของโพสต์ที่ระบุ

list

ส่งคืนรายการงานของหลักสูตรที่ผู้ขอได้รับอนุญาตให้ดู

modifyAssignees

แก้ไขโหมดผู้รับมอบหมายและตัวเลือกของการบ้านและรายงาน

patch

อัปเดตช่องอย่างน้อย 1 ช่องในงานของหลักสูตร