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

必要欄位。課程的 ID。
itemId

string

Announcement、CourseWork 或 CourseWorkMaterial 的 ID，應列舉其附件。這是必要欄位，不過在從 postId 進行遷移時，系統不會標示此欄位。

查詢參數

參數
postId
(deprecated)

string

選用設定。課程下方訊息 ID，該課程的附件僅供參考。已淘汰，請改用 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

詳情請參閱授權指南。