Method: courses.updateGradingPeriodSettings

과정의 평가 기간 설정을 업데이트합니다.

이 메서드를 사용하여 개별 평가 기간을 추가, 삭제 또는 수정할 수 있습니다.

요청하는 사용자와 과정 소유자는 채점 기간을 수정할 수 있어야 합니다. 자세한 내용은 라이선스 요구사항을 참고하세요.

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

  • 요청하는 사용자가 강의에서 평가 기간 설정을 수정할 수 없거나 액세스 오류가 있는 경우 PERMISSION_DENIED:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT: 요청 형식이 잘못된 경우
  • 요청된 과정이 없는 경우 NOT_FOUND입니다.

HTTP 요청

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

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

경로 매개변수

매개변수
courseId

string

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

쿼리 매개변수

매개변수
updateMask

string (FieldMask format)

GradingPeriodSettings에서 업데이트할 필드를 식별하는 마스크입니다.

GradingPeriodSettings gradingPeriods 목록이 업데이트 요청에 지정된 평가 기간으로 완전히 대체됩니다. 예를 들면 다음과 같습니다.

  • ID 없이 목록에 포함된 평가 기간은 추가로 간주되며 요청 시 새 ID가 할당됩니다.
  • 현재 존재하지만 요청에 누락된 평가 기간은 삭제된 것으로 간주됩니다.
  • 기존 ID와 수정된 데이터가 있는 평가 기간은 수정으로 간주됩니다. 수정되지 않은 데이터는 그대로 유지됩니다.
  • 알 수 없는 ID가 포함된 평가 기간은 오류가 발생합니다.

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

  • gradingPeriods
  • applyToExistingCoursework

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

enum (PreviewVersion)

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

요청 본문

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

응답 본문

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

승인 범위

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

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

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