Method: courses.create

コースを作成する。

ownerId で指定されたユーザーが、作成されたコースのオーナーであり、教師として追加されています。管理者以外のリクエストを行っているユーザーは、自身がオーナーであるコースのみを作成できます。ドメイン管理者は、ドメイン内のすべてのユーザーが所有するコースを作成できます。

このメソッドは、次のエラーコードを返します。

  • PERMISSION_DENIED: リクエスト元のユーザーがコースの作成を許可されていない場合、またはアクセスエラーのため。
  • 主担任が有効なユーザーでない場合は NOT_FOUND
  • FAILED_PRECONDITION: コースのオーナーのアカウントが無効になっている場合、または次のリクエスト エラーにより:
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
  • id で指定されたエイリアスがすでに存在する場合は ALREADY_EXISTS

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

リクエスト本文

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

レスポンスの本文

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

認可スコープ

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

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

詳細については、承認ガイドをご覧ください。