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

string

클래스룸에서 할당한 이 공지사항의 식별자로, 강의별로 고유합니다.

읽기 전용입니다.

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)

공지사항에 액세스할 수 있는 학생의 식별자입니다. 이 필드는 assigneeModeINDIVIDUAL_STUDENTS인 경우에만 설정됩니다. assigneeModeINDIVIDUAL_STUDENTS이면 이 입력란에 지정된 학생만 공지사항을 볼 수 있습니다.

creatorUserId

string

공지사항을 만든 사용자의 식별자입니다.

읽기 전용입니다.

AnnouncementState

공지사항의 가능한 상태

열거형
ANNOUNCEMENT_STATE_UNSPECIFIED 지정된 상태가 없습니다. 이 값은 반환되지 않습니다.
PUBLISHED 게시된 공지사항의 상태입니다. 이는 기본 상태입니다.
DRAFT 아직 게시되지 않은 공지사항의 상태입니다. 이 상태의 공지사항은 강의 교사와 도메인 관리자에게만 표시됩니다.
DELETED 게시되었지만 현재 삭제된 공지사항의 상태입니다. 이 상태의 공지사항은 강의 교사와 도메인 관리자에게만 표시됩니다. 이 상태의 공지사항은 일정 시간이 지나면 삭제됩니다.

메서드

create

공지사항을 만듭니다.

delete

공지사항을 삭제합니다.

get

공지사항을 반환합니다.

getAddOnContext

특정 게시물의 컨텍스트에서 클래스룸 부가기능의 메타데이터를 가져옵니다.

list

요청자가 볼 수 있는 공지사항 목록을 반환합니다.

modifyAssignees

담당자 모드 및 공지사항의 옵션을 수정합니다.

patch

공지사항의 필드를 하나 이상 업데이트합니다.