REST Resource: courses

{
  "id": string,
  "name": string,
  "section": string,
  "descriptionHeading": string,
  "description": string,
  "room": string,
  "ownerId": string,
  "creationTime": string,
  "updateTime": string,
  "enrollmentCode": string,
  "courseState": enum (CourseState),
  "alternateLink": string,
  "teacherGroupEmail": string,
  "courseGroupEmail": string,
  "teacherFolder": {
    object (DriveFolder)
  },
  "courseMaterialSets": [
    {
      object (CourseMaterialSet)
    }
  ],
  "guardiansEnabled": boolean,
  "calendarId": string,
  "gradebookSettings": {
    object (GradebookSettings)
  }
}

string

Identificatore di questo corso assegnato da Classroom.

Se creating a course, puoi impostare facoltativamente questo identificatore su un alias string nella richiesta per creare un alias corrispondente. Il id è ancora assegnato da Classroom e non può essere aggiornato dopo la creazione del corso.

Se specifichi questo campo in una maschera di aggiornamento del corso, verrà generato un errore.

string

Il nome del corso. Ad esempio, "Biologia di seconda superiore". Il nome è obbligatorio. Deve avere una lunghezza compresa tra 1 e 750 caratteri e deve essere una stringa UTF-8 valida.

string

Sezione del corso. ad esempio "Periodo 2". Se impostato, questo campo deve essere una stringa UTF-8 valida e non deve contenere più di 2800 caratteri.

string

Intestazione facoltativa per la descrizione. Ad esempio, "Ti do il benvenuto al corso di biologia della 10a classe". Se impostato, questo campo deve essere una stringa UTF-8 valida e non deve superare i 3600 caratteri.

string

Descrizione facoltativa. Ad esempio, "Impareremo la struttura degli esseri viventi attraverso una combinazione di libri di testo, lezioni di ospiti e lavori di laboratorio. Ti aspettano grandi cose." Se impostato, questo campo deve essere una stringa UTF-8 valida e non deve superare i 30.000 caratteri.

string

Posizione facoltativa della camera. Ad esempio, "301". Se impostato, questo campo deve essere una stringa UTF-8 valida e non deve superare i 650 caratteri.

string

L'identificatore del proprietario di un corso.

Se specificato come parametro di un create course request, questo campo è obbligatorio. L'identificatore può essere uno dei seguenti:

• L'identificatore numerico dell'utente
• l'indirizzo email dell'utente
• la stringa letterale "me", che indica l'utente che effettua la richiesta

Questo campo deve essere impostato in una richiesta di creazione. Gli amministratori possono anche specificare questo campo in un patch course request per trasferire la proprietà. In altri contesti è di sola lettura.

string (Timestamp format)

Data di creazione del corso. Se specifichi questo campo in una maschera di aggiornamento del corso, viene generato un errore.

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

string (Timestamp format)

Ora dell'aggiornamento più recente di questo corso. Se specifichi questo campo in una maschera di aggiornamento del corso, viene generato un errore.

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

string

Codice di registrazione da utilizzare per l'iscrizione a questo corso. Se specifichi questo campo in una maschera di aggiornamento del corso, viene generato un errore.

Sola lettura.

enum (CourseState)

Stato del corso. Se non specificato, lo stato predefinito è PROVISIONED.

string

Link assoluto a questo corso nell'interfaccia utente web di Classroom.

Sola lettura.

string

L'indirizzo email di un gruppo Google contenente tutti gli insegnanti del corso. Questo gruppo non accetta email e può essere utilizzato solo per le autorizzazioni.

Sola lettura.

string

L'indirizzo email di un gruppo Google contenente tutti i membri del corso. Questo gruppo non accetta email e può essere utilizzato solo per le autorizzazioni.

Sola lettura.

object (DriveFolder)

Informazioni su una cartella di Drive condivisa con tutti gli insegnanti del corso.

Questo campo verrà impostato solo per gli insegnanti del corso e per gli amministratori di dominio.

Sola lettura.

object (CourseMaterialSet)

Insiemi di materiali visualizzati nella pagina "Informazioni" di questo corso.

Sola lettura.

boolean

Indica se le notifiche per i tutori sono attive o meno per questo corso.

Sola lettura.

string

L'ID calendario di un calendario visibile a tutti i membri del corso, a cui Classroom aggiunge eventi per i lavori del corso e annunci durante il corso.

Il calendario di un corso viene creato in modo asincrono quando il corso viene impostato su CourseState.ACTIVE per la prima volta (al momento della creazione o quando viene aggiornato su CourseState.ACTIVE tramite l'interfaccia utente o l'API).ACTIVE L'ID calendario non verrà compilato finché non sarà completata la procedura di creazione.

Sola lettura.

object (GradebookSettings)

Le impostazioni del registro dei voti che specificano come verrà calcolato il voto complessivo di uno studente per il corso e a chi verrà mostrato.

Sola lettura

{
  "title": string,
  "materials": [
    {
      object (CourseMaterial)
    }
  ]
}

string

Titolo per questo set.

object (CourseMaterial)

Materiali allegati a questo set.

{

  // Union field material can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field material.
}

object (DriveFile)

Allegato di file di Google Drive.

object (YouTubeVideo)

Allegato video di YouTube.

object (Link)

Aggancio link.

object (Form)

Allegato di Moduli Google.

{
  "calculationType": enum (CalculationType),
  "displaySetting": enum (DisplaySetting),
  "gradeCategories": [
    {
      object (GradeCategory)
    }
  ]
}

enum (CalculationType)

Indica in che modo viene calcolato il voto complessivo.

enum (DisplaySetting)

Indica chi può visualizzare il voto complessivo.

object (GradeCategory)

Categorie di voto disponibili per i lavori del corso.