Method: courses.create

강의를 만듭니다.

ownerId에 지정된 사용자는 생성된 강의의 소유자이며 교사로 추가됩니다. 관리자가 아닌 요청 사용자는 자신을 소유자로 하는 강의만 만들 수 있습니다. 도메인 관리자는 도메인 내 모든 사용자가 소유한 강의를 만들 수 있습니다.

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

  • PERMISSION_DENIED 요청 사용자에게 강의를 만들 권한이 없거나 액세스 오류가 있는 경우
  • 기본 교사가 유효한 사용자가 아닌 경우 NOT_FOUND
  • FAILED_PRECONDITION 강의 소유자의 계정이 사용 중지되었거나 다음 요청 오류가 있는 경우
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
    • CourseTitleCannotContainUrl
  • id에 별칭이 지정되었고 이미 있는 경우 ALREADY_EXISTS

HTTP 요청

POST https://classroom.googleapis.com/v1/courses

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

쿼리 매개변수

파라미터
previewVersion

enum (PreviewVersion)

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

요청 본문

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

응답 본문

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

승인 범위

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

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

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