Method: courses.courseWork.studentSubmissions.list

Restituisce un elenco dei contenuti inviati dagli studenti che il richiedente può visualizzare, tenendo conto degli ambiti OAuth della richiesta. Puoi specificare - come courseWorkId per includere i lavori consegnati dagli studenti per più elementi di lavoro del corso.

Gli studenti del corso possono vedere solo i propri lavori. 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 all'utente che ha inviato la richiesta non è consentito accedere al corso o al lavoro del corso richiesto oppure in caso di errori di accesso.
  • INVALID_ARGUMENT se la richiesta non è valida.
  • 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

string

Identificatore del corso. Questo identificatore può essere l'identificatore assegnato da Classroom o un alias.

courseWorkId

string

Identificatore del lavoro dello studente da richiedere. Può essere impostato sul valore letterale stringa "-" per richiedere il lavoro dello studente per tutti i lavori del corso specificato.

Parametri di query

Parametri
userId

string

Argomento facoltativo per limitare i lavori restituiti dello studente a quelli di proprietà dello studente con l'identificatore specificato. L'identificatore può essere uno dei seguenti:

  • L'identificatore numerico dell'utente
  • l'indirizzo email dell'utente
  • il valore letterale della stringa "me", che indica l'utente che ha inviato la richiesta
states[]

enum (SubmissionState)

Stati di invio richiesti. Se specificato, i compiti restituiti dagli studenti corrispondono a uno degli stati di invio specificati.

late

enum (LateValues)

Valore di latenza richiesto. Se specificato, i contenuti inviati dagli studenti sono limitati dal valore richiesto. Se non specificato, i invii vengono restituiti indipendentemente dal valore di late.

pageSize

integer

Numero massimo di articoli da restituire. Zero o non specificato indica che il server può assegnare un numero massimo.

Il server potrebbe restituire un numero di risultati inferiore a quello specificato.

pageToken

string

Valore nextPageToken restituito da una chiamata list precedente, che indica che deve essere restituita la pagina dei risultati successiva.

La richiesta list deve essere altrimenti identica a quella che ha generato questo token.

previewVersion

enum (PreviewVersion)

(Facoltativo) La versione di anteprima dell'API. Questa impostazione deve essere impostata per accedere alle nuove funzionalità dell'API messe a disposizione degli sviluppatori nel Programma Anteprima.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta quando elenca i contenuti inviati dagli studenti.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "studentSubmissions": [
    {
      object (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
Campi
studentSubmissions[]

object (StudentSubmission)

Lavoro dello studente che corrisponde alla richiesta.

nextPageToken

string

Token che identifica la pagina successiva di risultati da restituire. Se viene lasciato vuoto, non sono disponibili altri 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 all'autorizzazione.

LateValues

Limitazioni relative al valore in ritardo degli elementi restituiti.

Enum
LATE_VALUES_UNSPECIFIED Nessuna limitazione specificata per i valori in ritardo per l'invio.
LATE_ONLY Restituire i contenuti inviati dallo studente dove il ritardo è effettivo.
NOT_LATE_ONLY Restituire i contenuti inviati dallo studente dove "late" è "false".