Method: courses.aliases.create

コースのエイリアスを作成します。

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

  • PERMISSION_DENIED: リクエスト元のユーザーにエイリアスの作成が許可されていない場合、またはアクセスエラーのため。
  • コースが存在しない場合は NOT_FOUND。
  • ALREADY_EXISTS（エイリアスがすでに存在する場合）。
  • FAILED_PRECONDITION: リクエストしたエイリアスがリクエスト元のユーザーまたはコースに適さない場合（ドメイン外のユーザーがドメイン スコープのエイリアスにアクセスしようとした場合など）。

HTTP リクエスト

POST https://classroom.googleapis.com/v1/courses/{courseId}/aliases

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

パスパラメータ

パラメータ
courseId

string

エイリアスに対するコースの識別子。この識別子は、Classroom で割り当てられた識別子または alias です。

リクエスト本文

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

レスポンスの本文

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

認可スコープ

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

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

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