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)
  },
  "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)

การประทับเวลาเมื่อสร้างงานในชั้นเรียนนี้

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็น Z เสมอ และใช้ตัวเลขเศษส่วน 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 เสมอ และใช้ตัวเลขเศษส่วน 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 เสมอ และใช้ตัวเลขเศษส่วน 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 เวอร์ชันตัวอย่างที่ใช้ในการดึงข้อมูลทรัพยากรนี้
ฟิลด์ Union 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 ฟิลด์ของงานในชั้นเรียน