REST Resource: courses.courseWork

Risorsa: CourseWork

Lavoro del corso creato da un insegnante per gli studenti del corso.

Rappresentazione JSON 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
}
Campi
courseId

string

Identificatore del corso.

Sola lettura.
id

string

Identificatore assegnato in classe a questo lavoro del corso, univoco per corso.

Sola lettura.
title

string

Il titolo di questo corso. Il titolo deve essere una stringa UTF-8 valida contenente da 1 a 3000 caratteri.
description

string

Descrizione facoltativa del lavoro del corso. Se impostata, la descrizione deve essere una stringa UTF-8 valida contenente non più di 30.000 caratteri.
materials[]

object (Material)

Materiali aggiuntivi.

CourseWork non può contenere più di 20 elementi materiali.
state

enum (CourseWorkState)

Stato del lavoro di questo corso. Se non specificato, lo stato predefinito è DRAFT.
creationTime

string (Timestamp format)

Timestamp del momento in cui è stato creato questo lavoro del corso.

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 lavoro del corso.

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".
dueDate

object (Date)

Data facoltativa, in UTC, in cui i lavori del corso devono essere inviati per la scadenza. È necessario specificare questo valore se dueTime è specificato.
dueTime

object (TimeOfDay)

L'ora del giorno facoltativa, nel fuso orario UTC, in cui è prevista la consegna dei lavori del corso. È necessario specificare questo valore se dueDate è specificato.
scheduledTime

string (Timestamp format)

Timestamp facoltativo della data in cui è prevista la pubblicazione del lavoro del corso.

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".
maxPoints

number

Voto massimo per il lavoro di questo corso. Se pari a zero o non specificato, questo compito è considerato senza voto. Deve essere un valore intero non negativo.
workType

enum (CourseWorkType)

Tipo di lavoro del corso.

Il tipo viene impostato al momento della creazione del lavoro del corso e non può essere modificato.
associatedWithDeveloper

boolean

Indica se questo elemento di lavoro del corso è associato al progetto della Developer Console che effettua la richiesta.

Per ulteriori dettagli, visita la pagina courseWork.create.

Sola lettura.
assigneeMode

enum (AssigneeMode)

Modalità assegnatario delle attività del corso. Se non specificato, il valore predefinito è ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identificatori degli studenti con accesso alle attività del corso. Questo campo è impostato solo se assigneeMode è INDIVIDUAL_STUDENTS. Se assigneeMode è INDIVIDUAL_STUDENTS, le attività del corso vengono assegnate solo agli studenti specificati in questo campo.
submissionModificationMode

enum (SubmissionModificationMode)

Impostazione per determinare quando gli studenti possono modificare i contenuti inviati. Se non specificato, il valore predefinito è MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

Identificatore dell'utente che ha creato le attività del corso.

Sola lettura.
topicId

string

Identificatore dell'argomento a cui è associato questo corso. Deve corrispondere a un argomento esistente nel corso.
gradeCategory

object (GradeCategory)

La categoria a cui contribuisce il voto di questo corso. Presentare solo quando è stata scelta una categoria per le attività del corso. Può essere utilizzato per calcolare il voto complessivo.

Sola lettura.
Campo di unione details. Ulteriori dettagli specifici per un tipo di lavoro del corso. details può essere solo uno dei seguenti:
assignment

object (Assignment)

Dettagli compito. Viene compilato solo quando workType è ASSIGNMENT.

Sola lettura.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

Dettagli della domanda a scelta multipla. Per le operazioni di lettura, questo campo viene compilato solo quando workType è MULTIPLE_CHOICE_QUESTION. Per le operazioni di scrittura, questo campo deve essere specificato durante la creazione di un lavoro del corso con un workType di MULTIPLE_CHOICE_QUESTION e non deve essere impostato in altro modo.

CourseWorkState

Gli stati possibili, ovviamente, funzionano.

Enum
COURSE_WORK_STATE_UNSPECIFIED Nessuno stato specificato. Questo non viene mai restituito.
PUBLISHED Stato del lavoro pubblicato. Questo è lo stato predefinito.
DRAFT Stato del lavoro non ancora pubblicato. I lavori in questo stato sono visibili solo agli insegnanti del corso e agli amministratori di dominio.
DELETED Stato del lavoro che è stato pubblicato, ma che ora è stato eliminato. I lavori in questo stato sono visibili solo agli insegnanti del corso e agli amministratori di dominio. I lavori in questo stato vengono eliminati dopo un certo periodo di tempo.

SubmissionModificationMode

Possibili modalità di modifica dei contenuti inviati dagli studenti.

Enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Nessuna modalità di modifica specificata. Questo non viene mai restituito.
MODIFIABLE_UNTIL_TURNED_IN I contenuti inviati possono essere modificati prima di essere consegnati.
MODIFIABLE I contenuti inviati possono essere modificati in qualsiasi momento.

Assignment

Ulteriori dettagli sui compiti.

Rappresentazione JSON 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
Campi
studentWorkFolder

object (DriveFolder)

Cartella di Drive in cui vengono inseriti gli allegati dei compiti consegnati dagli studenti. Questo campo viene compilato solo per gli insegnanti e gli amministratori del corso.

MultipleChoiceQuestion

Ulteriori dettagli per le domande a scelta multipla.

Rappresentazione JSON 
{
  "choices": [
    string
  ]
}
Campi
choices[]

string

Scelte possibili.

Metodi

create

 Crea il lavoro del corso.

delete

 Elimina il lavoro di un corso.

get

 Restituisce il lavoro del corso.

getAddOnContext

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

list

 Restituisce un elenco delle attività del corso che il richiedente è autorizzato a visualizzare.

modifyAssignees

 Modifica la modalità e le opzioni dell'assegnatario di un corso.

patch

 Consente di aggiornare uno o più campi di un lavoro del corso.