投稿の下にアドオンの添付ファイルを作成します。
アドオンには、投稿に新しい添付ファイルを作成する権限が必要です。
このメソッドは、次のエラーコードを返します。
PERMISSION_DENIED
: アクセスエラー。INVALID_ARGUMENT
: リクエストの形式が正しくない場合。- 識別されたリソースのいずれかが存在しない場合は
NOT_FOUND
。
HTTP リクエスト
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnAttachments
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
courseId |
必須。コースの識別子。 |
itemId |
添付ファイルを作成するお知らせ、courseWork、または courseWorkMaterial の識別子。このフィールドは必須ですが、postId からの移行ではマークされません。 |
クエリ パラメータ
パラメータ | |
---|---|
postId |
(省略可)非推奨です。代わりに itemId を使用してください。 |
addOnToken |
(省略可)リクエストを承認するトークン。 このトークンは、ユーザーが Classroom からアドオンの URL にリダイレクトされたときにクエリ パラメータとして渡されます。 この認証トークンは、Classroom 内で添付ファイルを作成する場合に必要ですが、パートナー ファーストの添付ファイルを作成する場合は任意です。パートナー優先のアタッチメント作成で指定されておらず、アタッチメントを作成したデベロッパー プロジェクトとその親ストリーム アイテムが一致しない場合は、エラーが返されます。 |
リクエスト本文
リクエストの本文には AddOnAttachment
のインスタンスが含まれています。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された AddOnAttachment
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/classroom.addons.teacher
詳細については、承認ガイドをご覧ください。