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)

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

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

enum (CourseWorkState)

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

string (Timestamp format)

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

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

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

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
dueDate

object (Date)

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

object (TimeOfDay)

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

string (Timestamp format)

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
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)

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

อ่านอย่างเดียว
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 ช่อง