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

クエリ パラメータ

パラメータ
previewVersion

enum (PreviewVersion)

省略可。API のプレビュー バージョン。プレビュー プログラムでデベロッパーが利用できる新しい API 機能にアクセスするには、この設定を行う必要があります。

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

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

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