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

詳しくは、認可ガイドをご覧ください。