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),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "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 ที่ใช้เพื่อดึงข้อมูลทรัพยากรนี้
learningGoals[]

object (LearningGoal)

ไม่บังคับ

การอ้างอิงถึงเป้าหมายการเรียนรู้ที่แนบมากับงานของชั้นเรียนนี้ การบ้านและรายงานมีเป้าหมายการเรียนรู้ได้สูงสุด 10 รายการ ระบบจะป้อนข้อมูลในช่องนี้ก็ต่อเมื่อมีการตั้งค่า previewVersion ที่เหมาะสมเท่านั้น
รายละเอียดเพิ่มเติมที่เฉพาะเจาะจงสำหรับประเภทงานของชั้นเรียน ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
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 ช่องของงานของชั้นเรียน