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

Описание этого объявления. Текст должен представлять собой действительную строку UTF-8, содержащую не более 30 000 символов.

materials[]

object ( Material )

Дополнительные материалы.

Объявления должны содержать не более 20 существенных пунктов.

state

enum ( AnnouncementState )

Статус этого объявления. Если не указано, состояние по умолчанию — DRAFT .

creationTime

string ( Timestamp format)

Временная метка создания этого объявления.

Только для чтения.

Использует RFC 3339, где генерируемые выходные данные всегда будут Z-нормализованы и используют 0, 3, 6 или 9 дробных цифр. Также принимаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

updateTime

string ( Timestamp format)

Временная метка последнего изменения этого объявления.

Только для чтения.

Использует RFC 3339, где генерируемые выходные данные всегда будут Z-нормализованы и используют 0, 3, 6 или 9 дробных цифр. Также принимаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

scheduledTime

string ( Timestamp format)

Необязательная временная метка, когда планируется опубликовать это объявление.

Использует RFC 3339, где генерируемые выходные данные всегда будут Z-нормализованы и используют 0, 3, 6 или 9 дробных цифр. Также принимаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

assigneeMode

enum ( AssigneeMode )

Режим правопреемника объявления. Если не указано, значение по умолчанию — ALL_STUDENTS .

individualStudentsOptions

object ( IndividualStudentsOptions )

Идентификаторы студентов, имеющих доступ к объявлению. Это поле устанавливается только в том случае, если assigneeMode имеет значение INDIVIDUAL_STUDENTS . Если assigneeMode имеет значение INDIVIDUAL_STUDENTS , то объявление смогут видеть только учащиеся, указанные в этом поле.

creatorUserId

string

Идентификатор пользователя, создавшего объявление.

Только для чтения.

Состояние объявления

Возможные состояния объявлений

Перечисления
ANNOUNCEMENT_STATE_UNSPECIFIED Штат не указан. Это никогда не возвращается.
PUBLISHED Статус опубликованного объявления. Это состояние по умолчанию.
DRAFT Статус объявления, которое еще не опубликовано. Объявление в этом состоянии видно только преподавателям курса и администраторам домена.
DELETED Статус объявления, которое было опубликовано, но сейчас удалено. Объявление в этом состоянии видно только преподавателям курса и администраторам домена. Объявление в таком состоянии через некоторое время удаляется.

Методы

create

 Создает объявление.

delete

 Удаляет объявление.

get

 Возвращает объявление.

getAddOnContext

 Получает метаданные для надстроек Класса в контексте определенного сообщения.

list

 Возвращает список объявлений, которые запрашивающему разрешено просматривать.

modifyAssignees

 Изменяет режим ответственного и параметры объявления.

patch

 Обновляет одно или несколько полей объявления.