Method: courses.courseWork.addOnAttachments.create

在訊息底下建立外掛程式附件。

您需要讓外掛程式具有在訊息建立新附件的權限。

這個方法會傳回下列錯誤代碼:

  • PERMISSION_DENIED 代表存取錯誤
  • 如果要求格式錯誤,則為 INVALID_ARGUMENT
  • NOT_FOUND:如果其中一項識別的資源不存在。

HTTP 要求

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
courseId

string

必要欄位。課程的 ID。

itemId

string

要建立連結的 AnnouncementCourseWorkCourseWorkMaterial ID。這是必要欄位,不過在從 postId 進行遷移時,系統不會標示此欄位。

查詢參數

參數
postId
(deprecated)

string

選用設定。已淘汰,請改用 itemId

addOnToken

string

選用設定。授權要求的權杖。

當使用者從 Classroom 重新導向至外掛程式的網址時,系統會將權杖做為查詢參數傳遞。

建立 Classroom 附件時需要這個授權權杖,但建立合作夥伴優先的附件時,不一定要提供這個授權權杖。如未在建立合作夥伴優先附件時提供錯誤,而建立附件與其父項串流項目的開發人員專案也不相符,則會傳回錯誤。

要求主體

要求主體包含 AddOnAttachment 的例項。

回應主體

如果成功,回應主體會包含新建立的 AddOnAttachment 例項。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱授權指南