Method: courses.announcements.modifyAssignees

修改公告的指派對象模式和選項。

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

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

  • PERMISSION_DENIED 如果要求存取的使用者沒有權限存取要求的課程或課程作業，或是發生存取錯誤。
  • INVALID_ARGUMENT：要求格式錯誤。
  • 如果要求的課程或課程作業不存在，則為 NOT_FOUND。
  • FAILED_PRECONDITION，因為發生下列要求錯誤：
    • EmptyAssignees

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

詳情請參閱授權指南。