Method: courses.courseWork.rubrics.patch

기준표를 업데이트합니다.

업데이트할 수 있는 필드에 관한 자세한 내용은 google.classroom.v1.Rubric를 참고하세요. 채점이 시작된 후에는 평가 기준 업데이트 기능이 제한됩니다.

요청하는 사용자와 과정 소유자에게는 평가 기준 생성 기능이 있어야 합니다. 자세한 내용은 라이선스 요구사항을 참고하세요.

이 요청은 상위 과정 과제 항목을 만드는 데 사용된 OAuth 클라이언트 ID의 Google Cloud 콘솔에서 해야 합니다.

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

  • 요청하는 개발자 프로젝트가 해당 과정 작업을 만들지 않았거나, 사용자가 루브릭에 요청된 수정사항을 적용할 권한이 없거나, 액세스 오류인 경우 PERMISSION_DENIED입니다. 이 오류 코드는 평가 기준에서 채점이 이미 시작된 경우에도 반환됩니다.
  • 요청 형식이 잘못되었으며 다음 요청 오류인 경우 INVALID_ARGUMENT입니다.
    • RubricCriteriaInvalidFormat
  • 요청된 과정, 과정 작업 또는 평가 기준이 없거나 사용자가 해당 과정 작업에 액세스할 수 없는 경우 NOT_FOUND
  • INTERNAL: 채점 기준에서 채점이 이미 시작된 경우

HTTP 요청

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

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

경로 매개변수

매개변수
courseId

string

필수 항목입니다. 과정의 식별자입니다.
courseWorkId

string

필수 항목입니다. 수업 과제의 식별자입니다.
id

string

선택사항입니다. 평가 기준의 식별자입니다.

쿼리 매개변수

매개변수
updateMask

string (FieldMask format)

선택사항입니다. 업데이트할 평가 기준의 필드를 식별하는 마스크입니다. 이 입력란은 업데이트를 수행하는 데 필요합니다. 잘못된 필드를 지정하면 업데이트가 실패합니다. sourceSpreadsheetId 및 criteria 목록 등 평가 기준을 정의하는 옵션은 여러 가지가 있습니다. 한 번에 하나의 기준만 사용하여 루브릭을 정의할 수 있습니다.

평가 기준 criteria 목록이 업데이트 요청에 지정된 평가 기준으로 완전히 대체됩니다. 예를 들어 요청에서 기준 또는 수준이 누락되면 삭제됩니다. 새로운 기준과 수준이 추가되고 ID가 할당됩니다. 기존 기준 및 수준은 요청에 ID가 지정된 경우 이전에 할당된 ID를 유지합니다.

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

  • criteria
  • sourceSpreadsheetId

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

enum (PreviewVersion)

선택사항입니다. API의 미리보기 버전입니다. 미리보기 프로그램에서 개발자에게 제공되는 새로운 API 기능에 액세스하려면 이 값을 설정해야 합니다.

요청 본문

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

응답 본문

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

승인 범위

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

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

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