Method: courses.courseWork.addOnAttachments.create

投稿の下にアドオンの添付ファイルを作成します。

投稿に新しい添付ファイルを作成する権限がアドオンに必要です。

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

  • PERMISSION_DENIED: アクセス エラー。
  • INVALID_ARGUMENT: リクエストの形式が正しくない場合。
  • NOT_FOUND: 識別されたリソースのいずれかが存在しない場合。

HTTP リクエスト

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments

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

パスパラメータ

パラメータ
courseId

string

必須。コースの識別子。
itemId

string

アタッチメントを作成する Announcement、CourseWork、または CourseWorkMaterial の ID。このフィールドは必須ですが、postId から移行中は必須としてマークされません。

クエリ パラメータ

パラメータ
postId
(deprecated)

string

省略可。非推奨。代わりに itemId を使用してください。
addOnToken

string

省略可。リクエストを承認するトークン。

トークンは、ユーザーが Classroom からアドオンの URL にリダイレクトされたときにクエリ パラメータとして渡されます。

この認可トークンは、Classroom 内でのアタッチメントの作成に必要ですが、パートナーが最初にアタッチメントを作成する場合は必要ありません。パートナー優先の添付ファイルの作成時に指定されず、添付ファイルを作成したデベロッパー プロジェクトとその親ストリーム アイテムが一致しない場合、エラーを返します。

リクエスト本文

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

レスポンスの本文

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

認可スコープ

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

  • https://www.googleapis.com/auth/classroom.addons.teacher

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