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

应枚举其附件的 Announcement、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

有关详情，请参阅授权指南。