Method: courses.courseWork.studentSubmissions.list

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

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 di stringa "-" per richiedere il lavoro dello studente per tutti i lavori del corso specificato.

Parametri di ricerca

Parametri
userId

string

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:

  • 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 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 late.
pageSize

integer

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

string

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

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

enum (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 (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
Campi
studentSubmissions[]

object (StudentSubmission)

Lavoro dello studente che corrisponde alla richiesta.
nextPageToken

string

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.