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

添付ファイルを作成するお知らせ、courseWork、または courseWorkMaterial の識別子。このフィールドは必須ですが、postId からの移行ではマークされません。

クエリ パラメータ

パラメータ
postId
(deprecated)

string

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

addOnToken

string

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

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

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

リクエスト本文

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

レスポンスの本文

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

認可スコープ

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

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

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