Skip to main content

course_work_materials

Overview

Namecourse_work_materials
TypeResource
Idgoogleworkspace.classroom.course_work_materials

Fields

NameDatatypeDescription
idstringClassroom-assigned identifier of this course work material, unique per course. Read-only.
descriptionstringOptional description of this course work material. The text must be a valid UTF-8 string containing no more than 30,000 characters.
creatorUserIdstringIdentifier for the user that created the course work material. Read-only.
individualStudentsOptionsobjectAssignee details about a coursework/announcement. This field is set if and only if assigneeMode is INDIVIDUAL_STUDENTS.
topicIdstringIdentifier for the topic that this course work material is associated with. Must match an existing topic in the course.
materialsarrayAdditional materials. A course work material must have no more than 20 material items.
updateTimestringTimestamp of the most recent change to this course work material. Read-only.
assigneeModestringAssignee mode of the course work material. If unspecified, the default value is ALL_STUDENTS.
scheduledTimestringOptional timestamp when this course work material is scheduled to be published.
titlestringTitle of this course work material. The title must be a valid UTF-8 string containing between 1 and 3000 characters.
courseIdstringIdentifier of the course. Read-only.
alternateLinkstringAbsolute link to this course work material in the Classroom web UI. This is only populated if state is PUBLISHED. Read-only.
statestringStatus of this course work material. If unspecified, the default state is DRAFT.
creationTimestringTimestamp when this course work material was created. Read-only.

Methods

NameAccessible byRequired ParamsDescription
courses_courseWorkMaterials_getSELECTcourseId, idReturns a course work material. This method returns the following error codes: PERMISSION_DENIED if the requesting user is not permitted to access the requested course or course work material, or for access errors. INVALID_ARGUMENT if the request is malformed. * NOT_FOUND if the requested course or course work material does not exist.
courses_courseWorkMaterials_listSELECTcourseIdReturns a list of course work material that the requester is permitted to view. Course students may only view PUBLISHED course work material. Course teachers and domain administrators may view all course work material. This method returns the following error codes: PERMISSION_DENIED if the requesting user is not permitted to access the requested course or for access errors. INVALID_ARGUMENT if the request is malformed. * NOT_FOUND if the requested course does not exist.
courses_courseWorkMaterials_createINSERTcourseIdCreates a course work material. This method returns the following error codes: PERMISSION_DENIED if the requesting user is not permitted to access the requested course, create course work material in the requested course, share a Drive attachment, or for access errors. INVALID_ARGUMENT if the request is malformed or if more than 20 materials are provided. NOT_FOUND if the requested course does not exist. FAILED_PRECONDITION for the following request error: AttachmentNotVisible
courses_courseWorkMaterials_deleteDELETEcourseId, idDeletes a course work material. This request must be made by the Developer Console project of the OAuth client ID used to create the corresponding course work material item. This method returns the following error codes: PERMISSION_DENIED if the requesting developer project did not create the corresponding course work material, if the requesting user is not permitted to delete the requested course or for access errors. FAILED_PRECONDITION if the requested course work material has already been deleted. * NOT_FOUND if no course exists with the requested ID.
courses_courseWorkMaterials_patchEXECcourseId, idUpdates one or more fields of a course work material. This method returns the following error codes: PERMISSION_DENIED if the requesting developer project for access errors. INVALID_ARGUMENT if the request is malformed. FAILED_PRECONDITION if the requested course work material has already been deleted. NOT_FOUND if the requested course or course work material does not exist