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)

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

string

공지사항을 작성한 사용자의 식별자입니다.

읽기 전용입니다.

AnnouncementState

공지사항의 가능한 상태

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

메서드

create

 공지사항을 만듭니다.

delete

 공지사항을 삭제합니다.

get

 공지사항을 반환합니다.

getAddOnContext

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

list

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

modifyAssignees

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

patch

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