Method: courses.courseWork.studentSubmissions.list

Restituisce un elenco di compiti dello studente che l'utente che effettua la richiesta può visualizzare, tenendo conto degli ambiti OAuth della richiesta. - può essere specificato come courseWorkId per includere i contenuti inviati dagli studenti per più elementi del 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 effettua la richiesta non è autorizzato ad accedere al corso o al lavoro 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

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 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 il lavoro dello studente restituito a quello 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
  • la stringa letterale "me", che indica l'utente che effettua la richiesta
states[]

enum (SubmissionState)

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

enum (LateValues)

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

integer

Il numero massimo di elementi da restituire. Zero o non specificato indica che il server può assegnare un valore massimo.

Il server potrebbe restituire meno del numero di risultati specificato.
pageToken

string

Valore nextPageToken restituito da una chiamata list precedente, che indica che deve essere restituita la pagina di 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. Questo valore deve essere impostato per accedere alle nuove funzionalità dell'API rese disponibili per gli sviluppatori nel Programma di anteprima.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta quando vengono elencati i 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)

Lavori degli studenti corrispondenti alla richiesta.
nextPageToken

string

Token che identifica la pagina di 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 sui valori inviati in ritardo specificata.
LATE_ONLY Restituisce StudentSubmissions dove late è true.
NOT_LATE_ONLY Restituisce StudentSubmissions dove late è falso.