REST Resource: courses.announcements

Zasób: ogłoszenie

Ogłoszenie utworzone przez nauczyciela dla uczniów zajęć

Zapis 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
}
Pola
courseId

string

Identyfikator zajęć.

Tylko do odczytu.
id

string

Przypisany przez Classroom identyfikator tego ogłoszenia, unikalny dla poszczególnych zajęć.

Tylko do odczytu.
text

string

Opis tego ogłoszenia. Tekst musi być prawidłowym ciągiem znaków UTF-8 i zawierać nie więcej niż 30 000 znaków.
materials[]

object (Material)

Dodatkowe materiały

Ogłoszenia mogą zawierać nie więcej niż 20 istotnych elementów.
state

enum (AnnouncementState)

Stan tego ogłoszenia. Jeśli stan nie jest określony, domyślny to DRAFT.
creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia tego ogłoszenia.

Tylko do odczytu.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Sygnatura czasowa ostatniej zmiany w tym ogłoszeniu.

Tylko do odczytu.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
scheduledTime

string (Timestamp format)

Opcjonalna sygnatura czasowa zaplanowanej publikacji tego ogłoszenia.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
assigneeMode

enum (AssigneeMode)

Tryb przypisanej osoby ogłoszenia. Jeśli wartość nie została określona, przyjmuje się wartość domyślną ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identyfikatory uczniów z dostępem do ogłoszenia. To pole jest ustawione tylko wtedy, gdy assigneeMode ma wartość INDIVIDUAL_STUDENTS. Jeśli assigneeMode ma wartość INDIVIDUAL_STUDENTS, tylko uczniowie wskazani w tym polu mogą zobaczyć ogłoszenie.
creatorUserId

string

Identyfikator użytkownika, który utworzył ogłoszenie.

Tylko do odczytu.

AnnouncementState

Możliwe stany ogłoszeń

Wartości w polu enum
ANNOUNCEMENT_STATE_UNSPECIFIED Nie określono stanu. Nigdy nie jest zwracany.
PUBLISHED Stan opublikowanego ogłoszenia. Jest to stan domyślny.
DRAFT Stan ogłoszenia, które nie zostało jeszcze opublikowane. Ogłoszenie w tym stanie jest widoczne tylko dla nauczycieli prowadzących zajęcia i administratorów domeny.
DELETED Stan ogłoszenia, które zostało opublikowane, ale zostało usunięte. Ogłoszenie w tym stanie jest widoczne tylko dla nauczycieli prowadzących zajęcia i administratorów domeny. Ogłoszenie w tym stanie zostanie po pewnym czasie usunięte.

Metody

create

 Tworzy ogłoszenie.

delete

 Usuwa ogłoszenie.

get

 Zwraca ogłoszenie.

getAddOnContext

 Pobiera metadane dodatków do Classroom w kontekście konkretnego posta.

list

 Zwraca listę ogłoszeń, które może wyświetlić osoba wysyłająca prośbę.

modifyAssignees

 Modyfikuje tryb przypisanej osoby i opcje ogłoszenia.

patch

 Aktualizuje co najmniej jedno pole ogłoszenia.