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。
pageToken

string

從先前 addOnAttachments.list 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 addOnAttachments.list 的所有其他參數須與提供網頁權杖的呼叫相符。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體會包含 ListAddOnAttachmentsResponse 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱授權指南。