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

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