- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- LateValues
- Prova!
Restituisce un elenco dei contenuti inviati dagli studenti che il richiedente è autorizzato a visualizzare, tenendo conto degli ambiti OAuth della richiesta. -
può essere specificato come courseWorkId
per includere i contenuti inviati dagli studenti per più elementi di lavoro del corso.
Gli studenti del corso possono visualizzare solo il proprio lavoro. Gli insegnanti del corso e gli amministratori di dominio possono visualizzare tutti i contenuti inviati dagli studenti.
Questo metodo restituisce i seguenti codici di errore:
PERMISSION_DENIED
se l'utente che ha inviato la richiesta non è autorizzato ad accedere al corso o al lavoro del corso richiesto oppure per errori di accesso.INVALID_ARGUMENT
se il formato della richiesta non è corretto.NOT_FOUND
se il corso richiesto non esiste.
Richiesta HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
courseId |
Identificatore del corso. Questo identificatore può essere l'identificatore assegnato da Classroom o un |
courseWorkId |
Identificatore del lavoro dello studente da richiedere. Può essere impostato sul valore letterale di stringa |
Parametri di ricerca
Parametri | |
---|---|
userId |
Argomento facoltativo per limitare i lavori restituiti dallo studente a quelli di sua proprietà con l'identificatore specificato. L'identificatore può essere uno dei seguenti:
|
states[] |
Stati di invio richiesti. Se specificato, i compiti restituiti dagli studenti corrispondono a uno degli stati di invio specificati. |
late |
Valore ritardo richiesto. Se specificato, i compiti restituiti dagli studenti sono limitati dal valore richiesto. Se non specificati, i contenuti inviati vengono restituiti indipendentemente dal valore |
pageSize |
Numero massimo di articoli da restituire. Zero o non specificato indica che il server può assegnare un limite massimo. Il server potrebbe restituire un numero di risultati inferiore a quello specificato. |
pageToken |
Valore La richiesta |
previewVersion |
Campo facoltativo. La versione di anteprima dell'API. Questa impostazione deve essere impostata per accedere alle nuove funzionalità API messe a disposizione degli sviluppatori nel Programma Anteprima. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Risposta durante l'elenco dei contenuti inviati dagli studenti.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"studentSubmissions": [
{
object ( |
Campi | |
---|---|
studentSubmissions[] |
Lavoro dello studente che corrisponde alla richiesta. |
nextPageToken |
Token che identifica la pagina successiva dei risultati da restituire. Se vuoto, non sono disponibili ulteriori risultati. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.students
https://www.googleapis.com/auth/classroom.coursework.me
Per ulteriori informazioni, consulta la Guida alle autorizzazioni.
LateValues
Limitazioni relative al valore recente degli elementi restituiti.
Enum | |
---|---|
LATE_VALUES_UNSPECIFIED |
Nessuna limitazione specificata per i valori in ritardo di invio. |
LATE_ONLY |
Restituire i contenuti inviati dallo studente quando si verifica il ritardo. |
NOT_LATE_ONLY |
Restituisci StudentSubmissions dove il ritardo è falso. |