REST Resource: courses.announcements

Zasób: Announcement

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

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 kursu.

Tylko do odczytu.
id

string

Identyfikator tego ogłoszenia przypisany przez Classroom, unikalny dla każdego kursu.

Tylko do odczytu.
text

string

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

object (Material)

dodatkowe materiały;

Ogłoszenia mogą zawierać maksymalnie 20 elementów.
state

enum (AnnouncementState)

Stan tego ogłoszenia. Jeśli nie określisz tego ustawienia, zostanie użyta wartość domyślna DRAFT.
creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia tego ogłoszenia.

Tylko do odczytu.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Sygnatura czasowa ostatniej zmiany tego ogłoszenia.

Tylko do odczytu.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
scheduledTime

string (Timestamp format)

Opcjonalny znacznik czasu, kiedy ogłoszenie ma zostać opublikowane.

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
assigneeMode

enum (AssigneeMode)

Tryb przypisania ogłoszenia. Jeśli nie podasz żadnej opcji, domyślna wartość to ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identyfikatory uczniów, którzy mają dostęp do ogłoszenia. To pole jest ustawiane tylko wtedy, gdy assigneeMode ma wartość INDIVIDUAL_STUDENTS. Jeśli wartość assigneeMode to INDIVIDUAL_STUDENTS, ogłoszenie mogą zobaczyć tylko uczniowie wskazani w tym polu.
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 podano stanu. Ten parametr 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 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 i administratorów domeny. Ogłoszenie w tym stanie jest usuwane po pewnym czasie.

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 przesyłająca prośbę.

modifyAssignees

 Modyfikuje tryb przypisania i opcje komunikatu.

patch

 Zaktualizuje co najmniej 1 pole ogłoszenia.