Method: courses.announcements.modifyAssignees

お知らせの割り当て先のモードとオプションを変更します。

このメソッドを呼び出すことができるのは、お知らせを含むコースの教師のみです。

このメソッドは以下のエラーコードを返します。

  • PERMISSION_DENIED: リクエストしたユーザーが、リクエストされたコースまたはコースの課題へのアクセスを許可されていない場合、またはアクセスエラーの場合。
  • INVALID_ARGUMENT: リクエストの形式が正しくない場合。
  • リクエストされたコースまたはコースの課題が存在しない場合は NOT_FOUND

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
courseId

string

コースの識別子。この識別子は、Classroom によって割り当てられた識別子か 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

詳細については、承認ガイドをご覧ください。