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)

設定哪些學生可以查看公告或查看公告。只有在 assigneeMode 為 INDIVIDUAL_STUDENTS 時，才需要指定。

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱授權指南。