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 in classe a 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 possono contenere più di 20 elementi materiali.
state

enum (AnnouncementState)

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

string (Timestamp format)

Timestamp della creazione dell'annuncio.

Sola lettura.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi 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 a questo annuncio.

Sola lettura.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi 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 pianificazione della pubblicazione dell'annuncio.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi 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 è 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 delle comunicazioni

Enum
ANNOUNCEMENT_STATE_UNSPECIFIED Nessuno stato specificato. Questo non viene mai restituito.
PUBLISHED Stato dell'annuncio che è stato 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 di dominio.
DELETED Lo stato dell'annuncio che è stato pubblicato, ma che è stato eliminato. L'annuncio in questo stato è 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

 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à dell'assegnatario e le opzioni di un annuncio.

patch

 Consente di aggiornare uno o più campi di un annuncio.