ส่วนเสริมของ Google Classroom พร้อมให้บริการแก่นักพัฒนาซอฟต์แวร์แล้ว โปรดดูข้อมูลเพิ่มเติมใน
เอกสารส่วนเสริม
Method: courses.courseWork.patch
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
อัปเดตช่องของงานในหลักสูตรอย่างน้อย 1 ช่อง
ดูรายละเอียดเกี่ยวกับช่องที่อาจอัปเดตและผู้ที่มีสิทธิ์เปลี่ยนแปลงได้ที่ google.classroom.v1.CourseWork
คำขอนี้ต้องส่งจากโปรเจ็กต์ Developer Console ของรหัสไคลเอ็นต์ OAuth ที่ใช้สร้างรายการงานในหลักสูตรที่เกี่ยวข้อง
วิธีการนี้จะแสดงรหัสข้อผิดพลาดต่อไปนี้
PERMISSION_DENIED หากโปรเจ็กต์ของนักพัฒนาแอปที่ส่งคำขอไม่ได้สร้างงานในหลักสูตรที่เกี่ยวข้อง หากผู้ใช้ไม่ได้รับอนุญาตให้ทำการแก้ไขที่นักเรียนส่งมาตามที่ขอ หรือหากมีข้อผิดพลาดในการเข้าถึงINVALID_ARGUMENT หากคำขอมีรูปแบบไม่ถูกต้องFAILED_PRECONDITION หากงานในหลักสูตรที่ขอถูกลบไปแล้วNOT_FOUND หากไม่มีหลักสูตรหรืองานในหลักสูตรที่ขอ
คำขอ HTTP
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{id}
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
| พารามิเตอร์ |
courseId |
string
ตัวระบุของหลักสูตร ตัวระบุนี้อาจเป็นตัวระบุที่ Classroom กำหนดหรือ alias ก็ได้
|
id |
string
ตัวระบุของงานในหลักสูตร
|
พารามิเตอร์การค้นหา
| พารามิเตอร์ |
updateMask |
string (FieldMask format)
หน้ากากที่ระบุฟิลด์ในชิ้นงานของหลักสูตรที่จะอัปเดต ต้องกรอกข้อมูลในช่องนี้เพื่ออัปเดต การอัปเดตจะดำเนินการไม่สำเร็จหากระบุช่องที่ไม่ถูกต้อง หากช่องรองรับค่าว่าง คุณสามารถล้างค่าได้โดยระบุในมาสก์การอัปเดต ไม่ใช่ในออบเจ็กต์ CourseWork หากช่องที่ไม่รองรับค่าว่างรวมอยู่ในมาสก์การอัปเดตและไม่ได้ตั้งค่าไว้ในออบเจ็กต์ CourseWork ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT ครูอาจระบุฟิลด์ต่อไปนี้
titledescriptionstatedueDatedueTimemaxPointsscheduledTimesubmissionModificationModetopicIdgradingPeriodId ซึ่งเป็นรายการชื่อฟิลด์ที่สมบูรณ์ในตัวเองที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"
|
previewVersion |
enum (PreviewVersion)
ไม่บังคับ API เวอร์ชันตัวอย่าง คุณต้องตั้งค่านี้เพื่อเข้าถึงความสามารถใหม่ๆ ของ API ที่พร้อมให้บริการแก่นักพัฒนาแอปในโปรแกรมเวอร์ชันตัวอย่าง
|
เนื้อความของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ CourseWork
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ CourseWork
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/classroom.coursework.students
ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[],[],null,["# Method: courses.courseWork.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates one or more fields of a course work.\n\nSee [google.classroom.v1.CourseWork](/workspace/classroom/reference/rest/v1/courses.courseWork#CourseWork) for details of which fields may be updated and who may change them.\n\nThis request must be made by the Developer Console project of the [OAuth client ID](https://support.google.com/cloud/answer/6158849) used to create the corresponding course work item.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting developer project did not create the corresponding course work, if the user is not permitted to make the requested modification to the student submission, or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `FAILED_PRECONDITION` if the requested course work has already been deleted.\n- `NOT_FOUND` if the requested course or course work does not exist.\n\n### HTTP request\n\n`PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{id}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Identifier of the course. This identifier can be either the Classroom-assigned identifier or an [alias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias). |\n| `id` | `string` Identifier of the course work. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Mask that identifies which fields on the course work to update. This field is required to do an update. The update fails if invalid fields are specified. If a field supports empty values, it can be cleared by specifying it in the update mask and not in the `CourseWork` object. If a field that does not support empty values is included in the update mask and not set in the `CourseWork` object, an `INVALID_ARGUMENT` error is returned. The following fields may be specified by teachers: - `title` - `description` - `state` - `dueDate` - `dueTime` - `maxPoints` - `scheduledTime` - `submissionModificationMode` - `topicId` - `gradingPeriodId` This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Optional. The preview version of the API. This must be set in order to access new API capabilities made available to developers in the Preview Program. |\n\n### Request body\n\nThe request body contains an instance of [CourseWork](/workspace/classroom/reference/rest/v1/courses.courseWork#CourseWork).\n\n### Response body\n\nIf successful, the response body contains an instance of [CourseWork](/workspace/classroom/reference/rest/v1/courses.courseWork#CourseWork).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.coursework.students`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
