Method: courses.courseWorkMaterials.patch

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

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

  • PERMISSION_DENIED: 액세스를 요청하는 개발자 프로젝트에 오류가 있는 경우
  • INVALID_ARGUMENT: 요청 형식이 잘못된 경우
  • FAILED_PRECONDITION: 요청된 과제 자료가 이미 삭제된 경우
  • NOT_FOUND: 요청된 과정 또는 과제 자료가 없는 경우

HTTP 요청

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

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

경로 매개변수

매개변수
courseId

string

과정의 식별자입니다. 이 식별자는 Classroom 할당 식별자 또는 alias일 수 있습니다.
id

string

과제 자료의 식별자입니다.

쿼리 매개변수

매개변수
updateMask

string (FieldMask format)

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

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

  • title
  • description
  • state
  • scheduledTime
  • topicId

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

enum (PreviewVersion)

선택사항입니다. 엔드포인트의 미리보기 버전입니다.

PREVIEW_VERSION_9001에는 다음과 같은 새로운 기능이 포함되어 있습니다. * 자료 업데이트가 지원됩니다. 자료를 업데이트하려면 updateMask 'materials'를 사용하세요. 요청의 CourseWorkMaterial 객체에 제공된 자료 목록이 기존 목록을 완전히 대체합니다. 자료 필드는 업데이트 마스크에 'materials'를 지정하고 CourseWorkMaterial 객체에는 지정하지 않아 지울 수 있습니다. 현재 게시된 CourseWorkMaterial 업데이트는 지원되지 않습니다.

요청 본문

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

응답 본문

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

승인 범위

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

  • https://www.googleapis.com/auth/classroom.courseworkmaterials

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