Method: courses.topics.create

トピックを作成します。

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

  • PERMISSION_DENIED: リクエスト元のユーザーが、リクエストされたコースへのアクセス、リクエストされたコース内のトピックの作成、アクセス エラーを許可されていない場合。
  • INVALID_ARGUMENT: リクエストの形式が正しくない場合。
  • ALREADY_EXISTS: コースに同じ名前のトピックが存在する場合。
  • FAILED_PRECONDITION: 次のリクエスト エラーの場合:
    • CourseTopicLimitReached
  • NOT_FOUND: リクエストされたコースが存在しない場合。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
courseId

string

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

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

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

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