REST Resource: courses.courseWork

Risorsa: attività del corso

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)
  },
  "previewVersion": enum (PreviewVersion),

  // 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.
  "gradingPeriodId": string
}
Campi
courseId

string

L'identificatore del corso.

Sola lettura.
id

string

Identificatore assegnato da Classroom di questo lavoro del corso, univoco per corso.

Sola lettura.
title

string

Il titolo di questo lavoro del corso. Il titolo deve essere una stringa UTF-8 valida contenente tra 1 e 3000 caratteri.
description

string

Descrizione facoltativa di questo 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 deve contenere più di 20 elementi del materiale.
state

enum (CourseWorkState)

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

string (Timestamp format)

Timestamp di creazione di questo lavoro del corso.

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 dell'ultima modifica apportata a questo compito.

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

object (Date)

Data facoltativa, in UTC, di scadenza per la consegna di questo lavoro del corso. Deve essere specificato se è specificato dueTime.
dueTime

object (TimeOfDay)

Ora del giorno facoltativa, in UTC, in cui devono essere consegnati i lavori per questo corso. Deve essere specificato se è specificato dueDate.
scheduledTime

string (Timestamp format)

Timestamp facoltativo in cui è prevista la pubblicazione di questo lavoro del corso.

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

number

Voto massimo per questa attività del corso. Se il valore è zero o non specificato, il compito viene considerato senza voto. Deve essere un numero intero non negativo.
workType

enum (CourseWorkType)

Tipo di questo lavoro del corso.

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

boolean

Indica se questo elemento del corso è associato al progetto della console per gli sviluppatori che effettua la richiesta.

Per maggiori dettagli, consulta courseWork.create.

Sola lettura.
assigneeMode

enum (AssigneeMode)

Modalità assegnatario del compito. Se non specificato, il valore predefinito è ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identificatori degli studenti con accesso al lavoro del corso. Questo campo viene impostato solo se assigneeMode è INDIVIDUAL_STUDENTS. Se assigneeMode è INDIVIDUAL_STUDENTS, solo agli studenti specificati in questo campo viene assegnato il compito.
submissionModificationMode

enum (SubmissionModificationMode)

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

string

Identificatore dell'utente che ha creato il compito.

Sola lettura.
topicId

string

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

object (GradeCategory)

La categoria a cui contribuisce il voto di questo compito. Viene visualizzato solo quando è stata scelta una categoria per il compito. Può essere utilizzato per calcolare il voto complessivo.

Sola lettura.
previewVersion

enum (PreviewVersion)

Solo output. La versione di anteprima dell'API utilizzata per recuperare questa risorsa.
Campo unione details. Dettagli aggiuntivi specifici per un tipo di lavoro del corso. details può essere solo uno dei seguenti:
assignment

object (Assignment)

Dettagli dell'assegnazione. Questo campo 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 quando si crea un compito con un workType di MULTIPLE_CHOICE_QUESTION e non deve essere impostato in caso contrario.
gradingPeriodId

string

Identificatore del periodo di valutazione associato al compito.

  • Al momento della creazione, se non specificato, l'ID periodo di valutazione verrà impostato in base a dueDate (o scheduledTime se non è impostato alcun dueDate).
  • Per indicare che non è associato ad alcun periodo di valutazione, imposta questo campo su una stringa vuota ("").
  • Se specificato, deve corrispondere a un ID periodo di valutazione esistente nel corso.

CourseWorkState

Stati possibili del lavoro del corso.

Enum
COURSE_WORK_STATE_UNSPECIFIED Nessuno stato specificato. Questo valore non viene mai restituito.
PUBLISHED Stato delle opere pubblicate. Questo è lo stato predefinito.
DRAFT Stato del lavoro non ancora pubblicato. Il lavoro in questo stato è visibile solo agli insegnanti del corso e agli amministratori di dominio.
DELETED Stato dell'opera pubblicata ma ora eliminata. Il lavoro in questo stato è visibile solo agli insegnanti del corso e agli amministratori di dominio. Il lavoro in questo stato viene eliminato dopo un po' di tempo.

SubmissionModificationMode

Possibili modalità di modifica per i contenuti inviati dagli studenti.

Enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Nessuna modalità di modifica specificata. Questo valore non viene mai restituito.
MODIFIABLE_UNTIL_TURNED_IN I compiti possono essere modificati prima di essere consegnati.
MODIFIABLE I contributi 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 degli invii degli 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

Possibili scelte.

Metodi

create

 Crea lavori del corso.

delete

 Elimina un compito.

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 di compiti del corso che il richiedente è autorizzato a visualizzare.

modifyAssignees

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

patch

 Aggiorna uno o più campi di un compito.