L'interfaccia utente di Classroom supporta cinque tipi di lavori del corso: Compiti, Compiti con quiz, Domande a risposta breve, Domande a scelta multipla e Materiali. Al momento, l'API Classroom supporta tre di questi tipi, noti come CourseWorkType
per l'API: Compiti, Domande a risposta breve e Domande a scelta multipla.
Materials
a CourseWorkType
risorse: Compiti, Domande a risposta breve e Domande a scelta multipla.
Per accedere a questa funzionalità, puoi utilizzare la risorsa CourseWork, che rappresenta un compito o una domanda assegnati agli studenti in un determinato corso, inclusi eventuali materiali e dettagli aggiuntivi, come la data di consegna o il punteggio massimo.
Oltre alla risorsa CourseWork, puoi gestire i compiti completati
con la risorsa StudentSubmission
. Nelle sezioni seguenti
sono descritti in modo più dettagliato.
Creare compiti
I compiti possono essere creati solo per conto degli insegnanti del corso e
tentare di creare compiti in un corso per conto di uno studente comporterà
l'errore 403 PERMISSION_DENIED
. Analogamente, anche gli amministratori di dominio non possono creare compiti per corsi di cui non sono insegnati e tentare di farlo tramite l'API comporterà l'errore 403 PERMISSION_DENIED
.
Quando crei assegnazioni utilizzando il metodo courses.courseWork.create
, puoi allegare i link come materials
, mostrato nel codice di esempio seguente:
Java
Python
Il risultato include un identificatore assegnato dal server che può essere utilizzato per fare riferimento all'assegnazione in altre richieste API.
Per includere i materiali collegati in un compito creato tramite l'API Classroom, utilizza una risorsa di collegamento, specificando l'URL di destinazione. Classroom recupera automaticamente l'immagine del titolo e della miniatura. L'API Classroom supporta inoltre in modo nativo i materiali di Google Drive e YouTube, che possono essere inclusi in una risorsa DriveFile o in una risorsa YouTubeVideo in modo simile.
Per specificare una data di scadenza, imposta i campi dueDate
e dueTime
sull'ora UTC corrispondente. La data di scadenza deve essere una data futura.
Recuperare compiti e domande
Puoi recuperare i compiti e le domande per studenti e insegnanti del corso corrispondente o da un amministratore di dominio. Per recuperare un compito o una domanda specifici, utilizza classroom.courseWork.get. Per recuperare tutti i compiti o le domande (che facoltativamente corrispondono ad alcuni criteri), utilizzacourses.courseWork.list.
L'ambito richiesto dipende dal ruolo dell'utente richiedente nel corso. Se l'utente è uno studente, utilizza uno dei seguenti ambiti:
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
Se l'utente è un insegnante o un amministratore di dominio, utilizza uno dei seguenti ambiti:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
Avere l'autorizzazione per recuperare un compito o una domanda non implica l'autorizzazione ad accedere ai materiali o ai metadati dei materiali. In pratica, ciò significa che un amministratore potrebbe non vedere il titolo di un file di Drive allegato se non è un membro del corso. Se vuoi consentire agli amministratori di accedere ai file dell'utente, consulta la guida alla delega a livello di dominio.
Gestire le risposte degli studenti
Una risorsa StudentSubmission
rappresenta il lavoro svolto e il voto di uno studente per un compito o una domanda. Quando viene creata una nuova domanda o un nuovo compito, viene implicitamente creata una risorsa StudentSubmission
per ogni studente.
Le sezioni seguenti spiegano le azioni comuni che gestiscono le risposte degli studenti.
Recuperare le risposte degli studenti
Gli studenti possono recuperare i propri contenuti inviati, gli insegnanti possono recuperare quelli inviati per tutti gli studenti dei corsi e gli amministratori di dominio possono recuperare tutti i contenuti inviati per tutti gli studenti del dominio. A ogni invio dello studente viene assegnato un identificatore; se lo conosci, utilizza courses.courseWork.studentSubmissions.get
per recuperarlo.
Utilizza il metodo courses.courseWork.studentSubmissions.list
per ottenere risorse StudentSubmission
che corrispondono ad alcuni criteri, come mostrato nell'esempio seguente:
Java
Python
Recupera le risorse StudentSubmission
che appartengono a uno studente specifico
specificando il parametro userId
, come mostrato nell'esempio seguente:
Java
Python
Gli studenti sono identificati tramite l'ID univoco o l'indirizzo email dell'utente, come
restituito dall'SDK Admin di Google. L'utente corrente può anche fare riferimento al proprio
ID utilizzando l'abbreviazione "me"
.
È anche possibile ricevere i compiti consegnati dagli studenti per tutti i compiti di un corso. Per farlo, utilizza il valore letterale "-"
come courseWorkId
, come mostrato nell'esempio seguente:
Java
service.courses().courseWork().studentSubmissions()
.list(courseId, "-")
.set("userId", userId)
.execute();
Python
service.courses().courseWork().studentSubmissions().list(
courseId=<course ID or alias>,
courseWorkId='-',
userId=<user ID>).execute()
L'ambito richiesto dipende dal ruolo dell'utente richiedente nel corso. Utilizza il seguente ambito se l'utente è un insegnante o un amministratore di dominio:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.students
Utilizza il seguente ambito se l'utente è uno studente:
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.me
Il fatto di disporre dell'autorizzazione per recuperare i contenuti inviati da uno studente non implica l'autorizzazione ad accedere agli allegati o ai metadati degli allegati. In pratica, ciò significa che un amministratore potrebbe non vedere il titolo di un file di Drive allegato se non è un membro del corso. Se vuoi consentire agli amministratori di accedere ai file degli utenti, consulta la guida relativa alla delega a livello di dominio.
Aggiungere allegati alla risposta di uno studente
Puoi allegare i link ai contenuti inviati da uno studente allegando una risorsa Link
,
DriveFile
o YouTubeVideo
. Questa operazione viene eseguita con courses.courseWork.studentSubmissions.modifyAttachments
, come mostrato nell'esempio seguente:
Java
Python
Un Allegato link viene definito dall'URL di destinazione; Classroom recupererà automaticamente il titolo e l'immagine della miniatura. Puoi scoprire gli altri materiali nelle rispettive pagine di riferimento.
La StudentSubmission
può essere modificata solo da un insegnante del corso o dallo studente proprietario. Puoi allegare Materials
solo se il valore
CourseWorkType
del compito inviato dallo studente è ASSIGNMENT
.
L'ambito richiesto dipende dal ruolo dell'utente richiedente nel corso. Utilizza il seguente ambito se l'utente è un insegnante:
https://www.googleapis.com/auth/classroom.coursework.students
Utilizza il seguente ambito se l'utente è uno studente:
https://www.googleapis.com/auth/classroom.coursework.me
Gestisci lo stato delle risposte degli studenti
La risposta di uno studente può essere annullata, consegnata o restituita. Il campo dello stato in StudentSubmission
indica lo stato attuale. Per modificare lo stato, chiama uno dei seguenti metodi:
courses.courseWork.studentSubmissions.turnIn
courses.courseWork.studentSubmissions.return
courses.courseWork.studentSubmissions.reclaim
Tutti questi metodi hanno un corpo vuoto. Esempio:
Java
Python
service.courses().courseWork().studentSubmission().turnIn(
courseId=<course ID or alias>,
courseWorkId=<courseWork ID>,
id=<studentSubmission ID>,
body={}).execute()
Solo lo studente proprietario di una StudentSubmission
può consegnarla o recuperarla.
Solo i contenuti consegnati possono essere rivendicati. Gli insegnanti del corso possono restituire solo un elemento
StudentSubmission
con stato consegnato.
Valutare le risposte degli studenti
La risorsa StudentSubmission
ha due campi in cui archiviare i voti:
assignedGrade
, che è il voto segnalato agli studenti, e draftGrade
,
che è un voto provvisorio visibile solo agli insegnanti. Questi campi vengono aggiornati utilizzando courses.courseWork.studentSubmissions.patch
con una maschera di campo contenente i campi appropriati, come mostrato nell'esempio seguente.
Java
Python
studentSubmission = {
'assignedGrade': 99,
'draftGrade': 80
}
service.courses().courseWork().studentSubmissions().patch(
courseId=<course ID or alias>,
courseWorkId=<courseWork ID>,
id=<studentSubmission ID>,
updateMask='assignedGrade,draftGrade',
body=studentSubmission).execute()
Quando utilizzano l'interfaccia utente di Classroom, gli insegnanti non possono assegnare un voto finché non hanno salvato un voto provvisorio. Il voto assegnato può quindi essere restituito a uno studente. Le applicazioni devono emulare questo comportamento. La tua applicazione può valutare il compito di uno studente in due modi:
Assegna solo l'
draftGrade
. Questo è utile, ad esempio, per consentire all'insegnante di rivedere manualmente i voti prima di finalizzarli. Gli studenti non possono visualizzare i voti provvisori.Assegna sia l'
draftGrade
sia l'assignedGrade
per assegnare la valutazione completa a un compito.
Elenca voti assegnati
Puoi elencare tutti i voti di un determinato elemento del corso esplorando l'oggetto di risposta del metodo courses.courseWork.studentSubmissions.list
:
Java
Python
response = coursework.studentSubmissions().list(
courseId=course_id,
courseWorkId=coursework_id,
pageSize=10).execute()
submissions.extend(response.get('studentSubmissions', []))
if not submissions:
print('No student submissions found.')
print('Student Submissions:')
for submission in submissions:
print(f"Submitted at:"
f"{(submission.get('userId'), submission.get('assignedGrade'))}")