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

お知らせの識別子。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

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

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