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

必要欄位。課程的 ID。

postId
(deprecated)

string

選用設定。課程下方訊息 ID,該課程的附件僅供參考。已淘汰,請改用 itemId

查詢參數

參數
itemId

string

AnnouncementCourseWorkCourseWorkMaterial 的 ID,應列舉其附件。這是必要欄位,不過在從 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

詳情請參閱授權指南