Method: courses.announcements.addOnAttachments.list

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

要求该插件对帖子具有有效的附件,或者有权对帖子创建新附件。

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

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

HTTP 请求

GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments

网址采用 gRPC 转码语法。

路径参数

参数
courseId

string

必需。课程的标识符。

itemId

string

应枚举其附件的 AnnouncementCourseWorkCourseWorkMaterial 的标识符。此字段是必填字段,但在从 postId 迁移期间未被标记为必填字段。

查询参数

参数
postId
(deprecated)

string

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

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

如需了解详情,请参阅授权指南