Method: courses.posts.addOnAttachments.list

返回帖子下由插件创建的所有附件。

要求插件在帖子上具有有效的附件,或者拥有在帖子中创建新附件的权限。

此方法会返回以下错误代码:

  • PERMISSION_DENIED访问错误
  • 如果请求格式有误,则返回 INVALID_ARGUMENT
  • 如果其中一个已标识的资源不存在,则为 NOT_FOUND

HTTP 请求

GET https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnAttachments

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

必需。课程的标识符。

postId
(deprecated)

string

可选。要枚举其附件的课程下帖子的标识符。已弃用,请改用 itemId。

查询参数

参数
itemId

string

应枚举其附件的公告、courseWork 或 courseWorkMaterial 的标识符。此字段是必填字段,但在从 postId 迁移时未标记为必填字段。

pageSize

integer

要返回的附件数量上限。服务返回的值可能小于此值。如果未指定,则最多返回 20 个附件。最大值为 20;大于 20 的值将被强制转换为 20。

pageToken

string

从之前的 addOnAttachments.list 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时,提供给 addOnAttachments.list 的所有其他参数必须与提供页面令牌的调用匹配。

请求正文

请求正文必须为空。

响应正文

如果成功,则响应正文包含一个 ListAddOnAttachmentsResponse 实例。

授权范围

需要以下 OAuth 范围之一:

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

有关详情,请参阅授权指南