REST Resource: courses.announcements

Materiał: 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 o długości nieprzekraczającej 30 000 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ślono inaczej, stan domyślny to DRAFT.
creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia tego ogłoszenia.

Tylko do odczytu.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy 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 formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy 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 opublikowania tego ogłoszenia.

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

enum (AssigneeMode)

Tryb osoby, której przypisano ogłoszenie. Jeśli wartość nie jest określona, wartością domyślną jest 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 assigneeMode to INDIVIDUAL_STUDENTS, ogłoszenie zobaczą tylko uczniowie określeni 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 określono stanu. Ta wartość nigdy nie jest zwracana.
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 zajęć i administratorów domeny.
DELETED Stan opublikowanego ogłoszenia, który został usunięty. Ogłoszenie w tym stanie jest widoczne tylko dla nauczycieli zajęć 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 dotyczące dodatków do Classroom w kontekście konkretnego posta.

list

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

modifyAssignees

 Modyfikuje tryb przypisywania osób i opcje ogłoszenia.

patch

 Aktualizuje jedno lub więcej pól ogłoszenia.