Method: courses.courseWork.studentSubmissions.list

Restituisce un elenco dei compiti inviati dagli studenti che il richiedente è autorizzato a visualizzare, tenendo conto degli ambiti OAuth della richiesta. È possibile specificare un trattino (-) come courseWorkId per includere i contenuti inviati dagli studenti per più elementi del corso.

Gli studenti del corso possono visualizzare solo il proprio lavoro. Gli insegnanti del corso e gli amministratori del dominio possono visualizzare tutti i compiti consegnati dagli studenti.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente richiedente non è autorizzato ad accedere al corso o al lavoro del corso richiesto oppure per 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

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

string

Identificatore del lavoro dello studente da richiedere. Questo valore può essere impostato sulla stringa letterale "-" per richiedere il lavoro degli studenti per tutti i lavori del corso specificato.

Parametri di query

Parametri
userId

string

Argomento facoltativo per limitare i lavori degli studenti restituiti 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 richiedente
states[]

enum (SubmissionState)

Stati invio richiesti. Se specificati, i contenuti inviati dagli studenti restituiti corrispondono a uno degli stati di invio specificati.
late

enum (LateValues)

Valore del ritardo richiesto. Se specificati, gli invii degli studenti restituiti sono limitati dal valore richiesto. Se non specificato, gli invii vengono restituiti indipendentemente dal valore di late.
pageSize

integer

Il numero massimo di elementi da restituire. Il valore zero o non specificato indica che il server può assegnare un valore 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 successiva dei risultati.

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 è necessaria per accedere alle nuove funzionalità API rese disponibili agli sviluppatori nel programma di anteprima.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta durante l'elenco dei compiti 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)

I lavori degli studenti che corrispondono alla richiesta.
nextPageToken

string

Token che identifica la pagina dei risultati successiva da restituire. Se è 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 al valore in ritardo degli articoli restituiti.

Enum
LATE_VALUES_UNSPECIFIED Nessuna limitazione specificata per i valori di ritardo dell'invio.
LATE_ONLY Restituisce StudentSubmissions in cui late è true.
NOT_LATE_ONLY Restituisci StudentSubmissions in cui late è false.