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

Identificatore del corso.

Sola lettura.
id

string

Identificatore assegnato da Classroom a questo avviso, univoco per ogni 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)

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

string (Timestamp format)

Timestamp della creazione di questo annuncio.

Sola lettura.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Timestamp della modifica più recente di questo annuncio.

Sola lettura.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
scheduledTime

string (Timestamp format)

Timestamp facoltativo della data e dell'ora programmate per la pubblicazione dell'annuncio.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
assigneeMode

enum (AssigneeMode)

Modalità assegnatario 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

Possibili stati 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. In questo stato, l'annuncio è visibile solo agli insegnanti del corso e agli amministratori di dominio.
DELETED Stato dell'annuncio che è stato pubblicato, ma che ora è stato eliminato. In questo stato, l'annuncio è visibile solo agli insegnanti del corso e agli amministratori di dominio. L'annuncio in questo stato viene eliminato dopo un po' di tempo.

Metodi

create

 Crea un annuncio.

delete

 Consente di eliminare un annuncio.

get

 Restituisce un annuncio.

getAddOnContext

 Recupera i metadati dei 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.