Method: courses.patch

강의에서 하나 이상의 필드를 업데이트합니다.

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

  • 요청한 사용자가 요청된 과정을 수정할 수 없는 경우 또는 액세스 오류의 경우 PERMISSION_DENIED
  • 요청된 ID의 과정이 없으면 NOT_FOUND
  • INVALID_ARGUMENT: 업데이트 마스크에 잘못된 필드가 지정되었거나 업데이트 마스크가 제공되지 않은 경우
  • 다음 요청 오류에 대해 FAILED_PRECONDITION를 사용합니다.
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner
    • CourseTitleCannotContainUrl

HTTP 요청

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

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

경로 매개변수

매개변수
id

string

업데이트할 강의의 식별자입니다. 이 식별자는 클래스룸 할당 식별자 또는 alias일 수 있습니다.

쿼리 매개변수

매개변수
updateMask

string (FieldMask format)

업데이트할 과정의 필드를 식별하는 마스크입니다. 업데이트하려면 이 필드가 필요합니다. 잘못된 필드를 지정하면 업데이트가 실패합니다. 다음 필드는 유효합니다.

  • name
  • section
  • descriptionHeading
  • description
  • room
  • courseState
  • ownerId

참고: ownerId에 대한 패치는 즉시 적용되는 것으로 처리되지만 실제로 영향을 받는 모든 리소스의 소유권 이전이 완료되는 데 시간이 걸릴 수 있습니다.

쿼리 매개변수에 설정된 경우 이 필드는 다음과 같이 지정해야 합니다.

updateMask=<field1>,<field2>,...

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

요청 본문

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

응답 본문

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

승인 범위

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

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

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