Creates an add-on attachment under a post.
Requires the add-on to have permission to create new attachments on the post.
This method returns the following error codes:
PERMISSION_DENIED
for access errors.INVALID_ARGUMENT
if the request is malformed.NOT_FOUND
if one of the identified resources does not exist.
HTTP request
POST https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnAttachments
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
courseId |
Required. Identifier of the course. |
postId |
Optional. Deprecated, use itemId instead. |
Query parameters
Parameters | |
---|---|
itemId |
Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from postId. |
addOnToken |
Optional. Token that authorizes the request. The token is passed as a query parameter when the user is redirected from Classroom to the add-on's URL. This authorization token is required for in-Classroom attachment creation but optional for partner-first attachment creation. Returns an error if not provided for partner-first attachment creation and the developer projects that created the attachment and its parent stream item do not match. |
Request body
The request body contains an instance of AddOnAttachment
.
Response body
If successful, the response body contains a newly created instance of AddOnAttachment
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/classroom.addons.teacher
For more information, see the Authorization guide.