Method: courses.courseWork.list

Restituisce un elenco dei lavori del corso che il richiedente è autorizzato a visualizzare.

Gli studenti del corso possono visualizzare solo i PUBLISHED lavori del corso. Gli insegnanti del corso e gli amministratori di dominio possono visualizzare tutto il lavoro del corso.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente che effettua la richiesta non è autorizzato ad accedere al corso richiesto o 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

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.

Parametri di query

Parametri
courseWorkStates[]

enum (CourseWorkState)

Limitazione dello stato del lavoro da restituire. Viene restituito solo il corso corrispondente. Se non specificato, vengono restituiti gli elementi con uno stato di lavoro pari a PUBLISHED.
orderBy

string

Ordinamento facoltativo dei risultati. Un elenco di campi separati da virgole con una parola chiave facoltativa per l'ordinamento. I campi supportati sono updateTime e dueDate. Le parole chiave per le direzioni supportate sono asc e desc. Se non specificato, updateTime desc è il comportamento predefinito. Esempi: dueDate asc,updateTime desc, updateTime,dueDate desc
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 si elenca il lavoro del corso.

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

Rappresentazione JSON 
{
  "courseWork": [
    {
      object (CourseWork)
    }
  ],
  "nextPageToken": string
}
Campi
courseWork[]

object (CourseWork)

Elementi del lavoro del corso 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.