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

この 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

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