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

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