REST Resource: courses.courseWork

Risorsa: attività del corso

Compiti del corso creati 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

Identificatore del corso.

Sola lettura.
id

string

Identificatore assegnato da Classroom a questo compito del corso, univoco per ogni corso.

Sola lettura.
title

string

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

Il programma del corso non deve contenere più di 20 elementi di materiale.
state

enum (CourseWorkState)

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

string (Timestamp format)

Timestamp della creazione del lavoro del corso.

Sola lettura.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo 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 al lavoro del corso.

Sola lettura.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo 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, entro la quale devono essere inviati i lavori per questo corso. Deve essere specificato se è specificato dueTime.
dueTime

object (TimeOfDay)

Ora facoltativa del giorno, in UTC, entro la quale i lavori del corso devono essere inviati. Deve essere specificato se è specificato dueDate.
scheduledTime

string (Timestamp format)

Timestamp facoltativo della data e dell'ora programmate per la pubblicazione del lavoro del corso.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo 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 del corso. Se è pari a zero o non è specificato, il compito viene 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 compito del corso è associato al progetto della console dello sviluppatore che effettua la richiesta.

Per ulteriori dettagli, visita la pagina courseWork.create.

Sola lettura.
assigneeMode

enum (AssigneeMode)

Modalità assegnatario del programma di studi. Se non specificato, il valore predefinito è ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

Identificatori degli studenti con accesso ai corsi. Questo campo viene impostato solo se assigneeMode è INDIVIDUAL_STUDENTS. Se assigneeMode è INDIVIDUAL_STUDENTS, il programma del corso viene assegnato 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 il programma dei corsi.

Sola lettura.
topicId

string

Identificatore dell'argomento a cui è associato il programma dei corsi. Deve corrispondere a un argomento esistente nel corso.
gradeCategory

object (GradeCategory)

La categoria a cui contribuisce il voto del corso. Viene visualizzato solo quando è stata scelta una categoria per i lavori del corso. Può essere utilizzato per il calcolo del 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 del compito. 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 crei il lavoro del corso con un valore workType di MULTIPLE_CHOICE_QUESTION e non deve essere impostato in altro modo.
gradingPeriodId

string

Identificatore del periodo di valutazione associato al programma di studi.

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

CourseWorkState

Possibili stati del lavoro del corso.

Enum
COURSE_WORK_STATE_UNSPECIFIED Nessuno stato specificato. Questo valore non viene mai restituito.
PUBLISHED Stato del lavoro che è stato 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 pubblicato, ma ora eliminato. I lavori in questo stato sono visibili 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 dei 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 contenuti inviati possono essere modificati prima della consegna.
MODIFIABLE I contenuti inviati possono essere modificati in qualsiasi momento.

Assignment

Ulteriori dettagli per i compiti.

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

object (DriveFolder)

Cartella di Drive in cui vengono inseriti gli allegati inviati 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

Possibili scelte.

Metodi

create

 Crea il lavoro del corso.

delete

 Consente di eliminare un compito del corso.

get

 Restituisce il lavoro del corso.

getAddOnContext

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

list

 Restituisce un elenco dei lavori del corso che il richiedente è autorizzato a visualizzare.

modifyAssignees

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

patch

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