- Risorsa: corso
- CourseState
- CourseMaterialSet
- CourseMaterial
- GradebookSettings
- CalculationType
- DisplaySetting
- Metodi
Risorsa: corso
Un corso in Classroom.
Rappresentazione JSON |
---|
{ "id": string, "name": string, "section": string, "descriptionHeading": string, "description": string, "room": string, "ownerId": string, "creationTime": string, "updateTime": string, "enrollmentCode": string, "courseState": enum ( |
Campi | |
---|---|
id |
Identificatore per questo corso assegnato da Classroom. Quando La specifica di questo campo in una maschera di aggiornamento del corso genera un errore. |
name |
Il nome del corso. Ad esempio, "Biologia della seconda media". Il nome è obbligatorio. Deve avere una lunghezza compresa tra 1 e 750 caratteri e una stringa UTF-8 valida. |
section |
Sezione del corso. ad esempio "Periodo 2". Se impostato, questo campo deve essere una stringa UTF-8 valida e non deve superare i 2800 caratteri. |
descriptionHeading |
Intestazione facoltativa per la descrizione. Ad esempio, "Ti diamo il benvenuto in biologia di terza media". Se impostato, questo campo deve essere una stringa UTF-8 valida e non deve superare i 3600 caratteri. |
description |
Descrizione facoltativa. Ad esempio, "Impareremo a conoscere la struttura degli esseri viventi grazie a una combinazione di libri di testo, lezioni per gli ospiti e lavori di laboratorio. Aspettati di essere entusiasti!" Se impostato, questo campo deve essere una stringa UTF-8 valida e non deve superare i 30.000 caratteri. |
room |
Posizione della stanza facoltativa. Ad esempio, "301". Se impostato, questo campo deve essere una stringa UTF-8 valida e non deve superare i 650 caratteri. |
ownerId |
L'identificatore del proprietario di un corso. Se specificato come parametro di
Questo deve essere impostato in una richiesta di creazione. Gli amministratori possono anche specificare questo campo in un |
creationTime |
Data e ora di creazione del corso. La specifica di questo campo in una maschera di aggiornamento del corso genera un errore. Sola lettura. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
updateTime |
Ora dell'aggiornamento più recente di questo corso. La specifica di questo campo in una maschera di aggiornamento del corso genera un errore. Sola lettura. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
enrollmentCode |
Codice di registrazione da utilizzare per partecipare a questo corso. La specifica di questo campo in una maschera di aggiornamento del corso genera un errore. Sola lettura. |
courseState |
Stato del corso. Se non specificato, lo stato predefinito è |
alternateLink |
Link assoluto a questo corso nell'interfaccia utente web di Classroom. Sola lettura. |
teacherGroupEmail |
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. |
courseGroupEmail |
L'indirizzo email di un gruppo Google che contiene tutti i membri del corso. Questo gruppo non accetta email e può essere utilizzato solo per le autorizzazioni. Sola lettura. |
teacherFolder |
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. |
courseMaterialSets[] |
Insieme di materiali che vengono visualizzati nella pagina "Informazioni" di questo corso. Sola lettura. |
guardiansEnabled |
Indica se le notifiche per i tutori sono attivate per questo corso. Sola lettura. |
calendarId |
L'ID del calendario di un calendario visibile a tutti i membri del corso, a cui Classroom aggiunge eventi per il lavoro e gli annunci del corso. Il calendario di un corso viene creato in modo asincrono quando il corso viene impostato per la prima volta su Sola lettura. |
gradebookSettings |
Le impostazioni del registro che specificano come verrà calcolato il voto complessivo di uno studente per il corso e a chi verrà mostrato. Sola lettura |
CourseState
Possibili stati in cui può trovarsi un corso.
Enum | |
---|---|
COURSE_STATE_UNSPECIFIED |
Nessuno stato del corso. Nessun messaggio di corso restituito utilizzerà questo valore. |
ACTIVE |
Il corso è attivo. |
ARCHIVED |
Il corso è stato archiviato. Non puoi modificarlo se non per passare a uno stato diverso. |
PROVISIONED |
Il corso è stato creato, ma non è ancora stato attivato. È accessibile all'insegnante principale e agli amministratori di dominio, che possono modificarlo o impostarlo come ACTIVE o DECLINED . Un corso può essere modificato in PROVISIONED solo se è nello stato DECLINED . |
DECLINED |
Il corso è stato creato, ma è stato rifiutato. È accessibile al proprietario del corso e agli amministratori di dominio, ma non verrà visualizzato nell'interfaccia utente web. Non puoi modificare il corso se non per passare allo stato PROVISIONED . Un corso può essere modificato in DECLINED solo se è nello stato PROVISIONED . |
SUSPENDED |
Il corso è stato sospeso. Non puoi modificare il corso e solo l'utente identificato da ownerId può visualizzarlo. Un corso può essere inserito in questo stato se potenzialmente viola i Termini di servizio. |
CourseMaterialSet
Un insieme di materiali che viene visualizzato nella pagina "Informazioni" del corso. Questi materiali possono includere un programma di studio, un programma o altre informazioni di base relative al corso nel suo complesso.
Rappresentazione JSON |
---|
{
"title": string,
"materials": [
{
object ( |
Campi | |
---|---|
title |
Titolo per questa serie. |
materials[] |
Materiali allegati a questa serie. |
CourseMaterial
Un materiale allegato a un corso come parte di un insieme di materiali.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione material . Dati dei materiali. material può essere solo uno dei seguenti: |
|
driveFile |
Allegato file di Google Drive. |
youTubeVideo |
Allegato video di YouTube. |
link |
Attacco dei link. |
form |
Allegato di Moduli Google. |
GradebookSettings
Le impostazioni del registro per un corso. Per maggiori dettagli, consulta questo articolo del Centro assistenza.
Rappresentazione JSON |
---|
{ "calculationType": enum ( |
Campi | |
---|---|
calculationType |
Indica come viene calcolato il voto complessivo. |
displaySetting |
Indica chi può vedere il voto complessivo. |
gradeCategories[] |
Le categorie di voto disponibili per le attività del corso. |
CalculationType
Possibili metodi di calcolo del voto complessivo.
Enum | |
---|---|
CALCULATION_TYPE_UNSPECIFIED |
Nessun metodo specificato. Questo non viene mai restituito. |
TOTAL_POINTS |
Il voto complessivo è la somma dei voti divisa per la somma dei punti totali indipendentemente dalla categoria. |
WEIGHTED_CATEGORIES |
Il voto complessivo è la media ponderata per categoria. |
DisplaySetting
Possibili impostazioni per visualizzare il voto complessivo.
Enum | |
---|---|
DISPLAY_SETTING_UNSPECIFIED |
Nessuna impostazione specificata. Questo non viene mai restituito. |
SHOW_OVERALL_GRADE |
Mostra il voto complessivo nel registro e nel profilo dello studente sia per gli insegnanti che per gli studenti. |
HIDE_OVERALL_GRADE |
Non mostra il voto complessivo nel registro o nel profilo dello studente. |
SHOW_TEACHERS_ONLY |
Mostra il voto complessivo agli insegnanti nel registro e nel profilo dello studente. Viene nascosta agli studenti nel loro profilo. |
Metodi |
|
---|---|
|
Indica se un utente è idoneo a creare allegati di componenti aggiuntivi in un determinato corso. |
|
Crea un corso. |
|
Elimina un corso. |
|
Restituisce un corso. |
|
Restituisce un elenco di corsi che l'utente richiedente è autorizzato a visualizzare, limitato a quelli che corrispondono alla richiesta. |
|
Consente di aggiornare uno o più campi di un corso. |
|
Aggiorna un corso. |