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)
  },
  "previewVersion": enum (PreviewVersion),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
Campi
courseId

string

Identificatore del corso.

Sola lettura.
id

string

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

Sola lettura.
title

string

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

string

Descrizione facoltativa di questo compito. 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 di materiale.
state

enum (CourseWorkState)

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

string (Timestamp format)

Timestamp di creazione di questo compito.

Sola lettura.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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 della modifica più recente apportata a questo compito del corso.

Sola lettura.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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 formato UTC, entro la quale devono essere inviati i compiti per questo corso. Questo valore deve essere specificato se è specificato dueTime.
dueTime

object (TimeOfDay)

(Facoltativo) Ora del giorno, in UTC, in cui devono essere inviati i compiti per questo corso. Questo valore deve essere specificato se è specificato dueDate.
scheduledTime

string (Timestamp format)

Timestamp facoltativo che indica quando è prevista la pubblicazione di questo lavoro del corso.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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 questo compito. Se il valore è zero o non è specificato, il compito viene considerato non valutato. Deve essere un valore intero non negativo.
workType

enum (CourseWorkType)

Il 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 compito è associato al progetto della Developer Console che effettua la richiesta.

Consulta courseWork.create per ulteriori dettagli.

Sola lettura.
assigneeMode

enum (AssigneeMode)

Modalità di assegnazione dei materiali del corso. Se non specificato, il valore predefinito è ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identificatori degli studenti con accesso ai materiali del corso. Questo campo viene 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 compiti inviati. Se non specificato, il valore predefinito è MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

Identificatore dell'utente che ha creato i materiali del corso.

Sola lettura.
topicId

string

Identificatore per l'argomento a cui sono associati questi materiali del corso. Deve corrispondere a un argomento esistente nel corso.
gradeCategory

object (GradeCategory)

La categoria a cui contribuisce il voto di questo lavoro del corso. Presente solo quando è stata scelta una categoria per i materiali del corso. 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.
learningGoals[]

object (LearningGoal)

Facoltativo.

Riferimenti a eventuali obiettivi di apprendimento collegati a questo lavoro del corso. CourseWork può avere al massimo 10 obiettivi di apprendimento. Questo campo viene compilato solo se è impostato l'previewVersion appropriato.
Dettagli aggiuntivi specifici per un tipo di lavoro del corso. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
assignment

object (Assignment)

Dettagli 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 durante la creazione di compiti del corso con un workType di MULTIPLE_CHOICE_QUESTION e non deve essere impostato in altro modo.
Fine dei campi che si escludono a vicenda.
gradingPeriodId

string

Identificatore del periodo di valutazione associato all'attività del corso.

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

CourseWorkState

Possibili stati dei compiti del corso.

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

SubmissionModificationMode

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

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

Assignment

Dettagli aggiuntivi per i compiti.

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

object (DriveFolder)

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

MultipleChoiceQuestion

Dettagli aggiuntivi per le domande a scelta multipla.

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

string

Possibili scelte.

Metodi

create

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

modifyAssignees

 Modifica la modalità e le opzioni degli assegnatari di un lavoro del corso.

patch

 Aggiorna uno o più campi di un lavoro del corso.