REST Resource: courses.announcements

Zasób: Announcement

Ogłoszenie utworzone przez nauczyciela dla uczniów uczestniczących w 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 szkolenia.

Tylko do odczytu.
id

string

Identyfikator ogłoszenia przypisany przez Classroom, unikalny w ramach zajęć.

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 000 znaków.
materials[]

object (Material)

Dodatkowe materiały.

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

enum (AnnouncementState)

Stan tego ogłoszenia. Jeśli nie określisz tu żadnej wartości, zostanie użyty stan domyślny DRAFT.
creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia tego ogłoszenia.

Tylko do odczytu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i używają 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Sygnatura czasowa ostatniej zmiany w tym ogłoszeniu.

Tylko do odczytu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i używają 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

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

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i używają 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
assigneeMode

enum (AssigneeMode)

Tryb przypisania ogłoszenia. Jeśli nie podasz żadnej opcji, domyślną wartością będzie 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 ma wartość INDIVIDUAL_STUDENTS, ogłoszenie mogą zobaczyć tylko uczniowie wymienieni 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. Nie jest on nigdy 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 kursu i administratorów domeny.
DELETED Stan ogłoszenia, które zostało opublikowane, ale jest teraz usunięte. Ogłoszenie w tym stanie jest widoczne tylko dla nauczycieli kursu 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 Google Classroom w kontekście konkretnego posta.

list

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

modifyAssignees

 Zmienia tryb przypisania i opcje ogłoszenia.

patch

 Aktualizuje co najmniej jedno pole ogłoszenia.