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 Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には Course のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された Course のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

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

詳しくは、承認ガイドをご覧ください。