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 dalla classe 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 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 nel formato RFC3339 UTC "Zulu" 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 nel formato RFC3339 UTC "Zulu" 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 pubblicazione dell'annuncio.

Un timestamp nel formato RFC3339 UTC "Zulu" 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à dell'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 il assigneeMode è INDIVIDUAL_STUDENTS, solo gli studenti specificati in questo campo possono vedere l'annuncio.

creatorUserId

string

Identificatore per l'utente che ha creato l'annuncio.

Sola lettura.

AnnouncementState

Possibili stati degli annunci

Enum
ANNOUNCEMENT_STATE_UNSPECIFIED Nessuno stato specificato. 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 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

Aggiorna uno o più campi di un annuncio.