REST Resource: courses.announcements

Risorsa: Annuncio

Annuncio creato da un insegnante per gli studenti del corso

Rappresentazione 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
}
Campi
courseId

string

L'identificatore del corso.

Sola lettura.
id

string

Identificatore assegnato da Classroom di questo annuncio, univoco per corso.

Sola lettura.
text

string

Descrizione di questo annuncio. Il testo deve essere una stringa UTF-8 valida contenente non più di 30.000 caratteri.
materials[]

object (Material)

Materiali aggiuntivi.

Gli annunci non devono contenere più di 20 elementi di materiale.
state

enum (AnnouncementState)

Lo stato di questo annuncio. Se non specificato, lo stato predefinito è DRAFT.
creationTime

string (Timestamp format)

Timestamp di creazione di questo annuncio.

Sola lettura.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Timestamp della modifica più recente di questo annuncio.

Sola lettura.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

Timestamp facoltativo in cui è prevista la pubblicazione di questo annuncio.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
assigneeMode

enum (AssigneeMode)

Modalità di assegnazione dell'annuncio. Se non specificato, il valore predefinito è ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identificatori degli studenti con accesso all'annuncio. Questo campo viene impostato solo se assigneeMode è INDIVIDUAL_STUDENTS. Se assigneeMode è INDIVIDUAL_STUDENTS, solo gli studenti specificati in questo campo possono vedere l'annuncio.
creatorUserId

string

Identificatore dell'utente che ha creato l'annuncio.

Sola lettura.

AnnouncementState

Stati possibili degli annunci

Enum
ANNOUNCEMENT_STATE_UNSPECIFIED Nessuno stato specificato. Questo valore non viene mai restituito.
PUBLISHED Stato dell'annuncio pubblicato. Questo è lo stato predefinito.
DRAFT Stato di un annuncio non ancora pubblicato. L'annuncio in questo stato è visibile solo agli insegnanti del corso e agli amministratori del dominio.
DELETED Stato dell'annuncio pubblicato ma ora eliminato. L'annuncio in questo stato è visibile solo agli insegnanti del corso e agli amministratori del dominio. L'annuncio in questo stato viene eliminato dopo un po' di tempo.

Metodi

create

 Crea un annuncio.

delete

 Elimina un annuncio.

get

 Restituisce un annuncio.

getAddOnContext

 Recupera i metadati per i componenti aggiuntivi di Classroom nel contesto di un post specifico.

list

 Restituisce un elenco di annunci che il richiedente è autorizzato a visualizzare.

modifyAssignees

 Modifica la modalità e le opzioni di assegnazione di un annuncio.

patch

 Aggiorna uno o più campi di un annuncio.