Method: courses.announcements.modifyAssignees

修改指派者模式和公告選項。

只有含有公告的課程老師可以呼叫這個方法。

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

  • PERMISSION_DENIED 如果要求使用者未獲准存取要求的課程或課程作業,或是發生存取錯誤
  • INVALID_ARGUMENT:如果要求格式錯誤。
  • NOT_FOUND:如果要求的課程或課程作業不存在。

HTTP 要求

POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{id}:modifyAssignees

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

路徑參數

參數
courseId

string

課程的 ID。這個 ID 可以是 Classroom 指派的 ID 或 alias

id

string

公告的 ID。

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "assigneeMode": enum (AssigneeMode),
  "modifyIndividualStudentsOptions": {
    object (ModifyIndividualStudentsOptions)
  }
}
欄位
assigneeMode

enum (AssigneeMode)

公告的模式,說明公告是否可供所有學生或特定個別學生存取。

modifyIndividualStudentsOptions

object (ModifyIndividualStudentsOptions)

設定哪些學生可以查看或無法查看公告。只有在 assigneeModeINDIVIDUAL_STUDENTS 時,才需要指定。

回應主體

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

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/classroom.announcements

詳情請參閱授權指南