Method: courses.announcements.addOnAttachments.create

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

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

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

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

HTTP リクエスト

POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{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

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