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

Identificatore del corso.

Sola lettura.

id

string

Identificatore assegnato dalla classe di questo lavoro del corso, univoco per corso.

Sola lettura.

title

string

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

Le attività del corso non possono contenere più di 20 materiali.

state

enum (CourseWorkState)

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

creationTime

string (Timestamp format)

Timestamp della creazione di questo lavoro del corso.

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

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

dueDate

object (Date)

Data facoltativa, in UTC, di scadenza per l'invio di lavori del corso. Deve essere specificato se dueTime è specificato.

dueTime

object (TimeOfDay)

Ora del giorno facoltativa, in UTC, in cui sono previsti i lavori di questo corso. Deve essere specificato se dueDate è specificato.

scheduledTime

string (Timestamp format)

Timestamp facoltativo per la pubblicazione di questo lavoro del corso.

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

maxPoints

number

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

workType

enum (CourseWorkType)

Il tipo di lavoro di questo corso.

Il tipo viene impostato quando viene creato il lavoro del corso e non può essere modificato.

associatedWithDeveloper

boolean

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

Per maggiori 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 viene impostato solo se assigneeMode è INDIVIDUAL_STUDENTS. Se il assigneeMode è INDIVIDUAL_STUDENTS, le attività del corso vengono assegnate solo agli studenti specificati in questo campo.

submissionModificationMode

enum (SubmissionModificationMode)

Impostazione per stabilire quando gli studenti sono autorizzati a modificare i contenuti inviati. Se non specificato, il valore predefinito è MODIFIABLE_UNTIL_TURNED_IN.

creatorUserId

string

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

Sola lettura.

topicId

string

Identificatore per l'argomento a cui è associata questa attività del 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.

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. Il campo viene compilato solo quando il valore di 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 lavori del corso con un workType di MULTIPLE_CHOICE_QUESTION e non deve essere impostato in altro modo.

gradingPeriodId

string

Identificatore del periodo di valutazione associato alle attività del corso.

  • Se non specificato, l'ID del periodo di valutazione verrà impostato in base al dueDate (o al scheduledTime se non è impostato alcun dueDate).
  • Per indicare nessuna associazione 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

I possibili stati del corso funzionano.

Enum
COURSE_WORK_STATE_UNSPECIFIED Nessuno stato specificato. Non viene mai restituito.
PUBLISHED Stato dell'opera che è stata pubblicata. Questo è lo stato predefinito.
DRAFT Stato dell'opera non ancora pubblicata. Il lavoro in questo stato è visibile solo agli insegnanti del corso e agli amministratori di dominio.
DELETED Stato dell'opera che è stata pubblicata, ma che è stata 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 dei contenuti inviati dagli studenti.

Enum
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED Nessuna modalità di modifica specificata. 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 sulle assegnazioni.

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

object (DriveFolder)

Cartella di Drive in cui vengono inseriti gli allegati dei contenuti inviati dagli studenti. Il 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

Scelte possibili.

Metodi

create

Crea il lavoro del corso.

delete

Elimina il lavoro di un corso.

get

Restituisce i lavori del corso.

getAddOnContext

Recupera i metadati per i 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 dell'assegnatario di un'attività del corso.

patch

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