REST Resource: courses.courseWork

แหล่งข้อมูล: 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)
  },
  "previewVersion": enum (PreviewVersion),

  // 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.
  "gradingPeriodId": string
}
ช่อง
courseId

string

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

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

string

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

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

string

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

string

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

object (Material)

สื่อการเรียนการสอนเพิ่มเติม

CourseWork ต้องมีรายการสื่อการเรียนการสอนไม่เกิน 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

เกรดสูงสุดสำหรับงานของหลักสูตรนี้ หากไม่มีหรือไม่ได้ระบุ จะถือว่างานนี้ยังไม่ได้ให้คะแนน ค่านี้ต้องเป็นจำนวนเต็มที่ไม่ติดลบ
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)

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

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

enum (PreviewVersion)

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

object (Assignment)

รายละเอียดงาน ระบบจะป้อนข้อมูลเฉพาะเมื่อ workType คือ ASSIGNMENT

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

object (MultipleChoiceQuestion)

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

string

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

  • หากไม่ระบุ ระบบจะกำหนดรหัสระยะเวลาการให้คะแนนตาม dueDate (หรือ scheduledTime หากไม่ได้ตั้ง dueDate ไว้)
  • หากต้องการระบุว่าไม่มีการเชื่อมโยงกับระยะเวลาการให้คะแนน ให้ตั้งค่าช่องนี้เป็นสตริงว่าง ("")
  • หากระบุ รหัสต้องตรงกับรหัสระยะเวลาการให้คะแนนที่มีอยู่ในหลักสูตร

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 ช่อง