ユーザーが Classroom と Google Meet を使用している場合は、Google Meet コースの生徒の出席状況を確認する Apps Script クイックスタートをご覧ください。

REST Resource: courses.announcements

リソース: お知らせ

コースの生徒向けに教師が作成したお知らせ

JSON 表現
{
  "courseId": string,
  "id": string,
  "text": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (AnnouncementState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "creatorUserId": string
}
フィールド
courseId

string

コースの ID。

読み取り専用です。

id

string

Classroom によって割り当てられたこのお知らせの ID(コースごとに一意)。

読み取り専用です。

text

string

このお知らせの説明。テキストは 30,000 文字以下の有効な UTF-8 文字列にする必要があります。

materials[]

object (Material)

補足資料。

お知らせの資料は 20 項目以下にする必要があります。

state

enum (AnnouncementState)

このお知らせのステータス。指定しない場合のデフォルトの状態は DRAFT です。

creationTime

string (Timestamp format)

このお知らせが作成されたときのタイムスタンプ。

読み取り専用です。

RFC3339 UTC「Zulu」形式のタイムスタンプ。解像度はナノ秒、小数点以下は 9 桁まで。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

最近行われた変更のタイムスタンプ。

読み取り専用です。

RFC3339 UTC「Zulu」形式のタイムスタンプ。解像度はナノ秒、小数点以下は 9 桁まで。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

scheduledTime

string (Timestamp format)

このお知らせを公開する予定のスケジュールのタイムスタンプ(省略可)。

RFC3339 UTC「Zulu」形式のタイムスタンプ。解像度はナノ秒、小数点以下は 9 桁まで。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

assigneeMode

enum (AssigneeMode)

お知らせの [割り当て先] モード。指定しない場合、デフォルト値は ALL_STUDENTS です。

individualStudentsOptions

object (IndividualStudentsOptions)

お知らせにアクセスできる生徒の ID。このフィールドは、assigneeModeINDIVIDUAL_STUDENTS の場合にのみ設定されます。assigneeModeINDIVIDUAL_STUDENTS の場合は、この欄で指定した生徒だけがお知らせを見ることができます。

creatorUserId

string

お知らせを作成したユーザーの ID。

読み取り専用です。

お知らせの状態

お知らせのステータス

列挙型
ANNOUNCEMENT_STATE_UNSPECIFIED 州が指定されていません。返されることはありません。
PUBLISHED 公開されたお知らせのステータス。これはデフォルトの状態です。
DRAFT まだ公開されていないお知らせのステータス。このステータスのお知らせは、コースの教師とドメイン管理者にのみ表示されます。
DELETED お知らせは公開されていますが、現在は削除されています。このステータスのお知らせは、コースの教師とドメイン管理者にのみ表示されます。このステータスのお知らせはしばらくすると削除されます。

メソッド

create

お知らせを作成します。

delete

お知らせを削除します。

get

お知らせを返します。

list

リクエスト送信者が閲覧を許可したお知らせのリストを返します。

modifyAssignees

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

patch

お知らせの 1 つ以上のフィールドを更新します。