Method: courses.update

コースを更新します。

注: 他のフィールドとは異なり、リクエストから除外されても levels はクリアされません。courses.update メソッドは、明示的に指定された場合にのみ levels を変更します。それ以外の場合は、既存の値が保持されます。courses.patch メソッドを使用して levels フィールドをクリアします。

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

  • リクエストしたユーザーがリクエストされたコースの変更を許可されていない場合、またはアクセスエラーが発生した場合に PERMISSION_DENIED を返します。
  • リクエストされた ID のコースが存在しない場合は NOT_FOUND。
  • 次のリクエスト エラーの FAILED_PRECONDITION:
    • CourseNotModifiable
    • CourseTitleCannotContainUrl

HTTP リクエスト

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

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

パスパラメータ

パラメータ
id

string

更新するコースの識別子。この識別子は、Classroom 割り当ての識別子または alias のいずれかです。

クエリ パラメータ

パラメータ
previewVersion

enum (PreviewVersion)

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

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

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

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