Method: courses.courseWork.patch

수업 과제의 필드를 하나 이상 업데이트합니다.

업데이트할 수 있는 필드와 변경할 수 있는 대상에 관한 자세한 내용은 google.classroom.v1.CourseWork를 참고하세요.

이 요청은 해당 과정 작업 항목을 만드는 데 사용된 OAuth 클라이언트 ID의 Play Console 프로젝트를 통해 이루어져야 합니다.

이 메서드는 다음 오류 코드를 반환합니다.

  • 요청하는 개발자 프로젝트에서 상응하는 과정 과제물을 생성하지 못했거나, 사용자가 학생이 제출한 과제에서 요청된 수정을 할 수 없는 경우, 또는 액세스 오류가 발생한 경우 PERMISSION_DENIED입니다.
  • INVALID_ARGUMENT: 요청 형식이 잘못된 경우
  • 요청된 수업 과제가 이미 삭제된 경우 FAILED_PRECONDITION입니다.
  • NOT_FOUND이며 요청된 강의, 수업 과제 또는 학생 제출물이 없는 경우 표시됩니다.

HTTP 요청

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{id}

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
courseId

string

과정의 식별자입니다. 이 식별자는 클래스룸에서 할당한 식별자 또는 alias일 수 있습니다.

id

string

수업 과제의 식별자입니다.

쿼리 매개변수

매개변수
updateMask

string (FieldMask format)

과정에서 업데이트할 필드를 식별하는 마스크입니다. 업데이트하려면 이 필드가 필요합니다. 잘못된 필드가 지정되면 업데이트가 실패합니다. 필드에서 빈 값을 지원하는 경우 CourseWork 객체가 아닌 업데이트 마스크에서 지정하여 지울 수 있습니다. 빈 값을 지원하지 않는 필드가 업데이트 마스크에 포함되어 있고 CourseWork 객체에 설정되지 않은 경우 INVALID_ARGUMENT 오류가 반환됩니다.

다음 필드는 교사가 지정할 수 있습니다.

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId

필드의 정규화된 이름을 쉼표로 구분한 목록입니다. 예: "user.displayName,photo"

요청 본문

요청 본문에는 CourseWork의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 CourseWork의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/classroom.coursework.students

자세한 내용은 승인 가이드를 참고하세요.