Method: courses.courseWorkMaterials.list

Restituisce un elenco di materiale didattico del corso che il richiedente è autorizzato a visualizzare.

Gli studenti del corso possono visualizzare solo il materiale didattico del corso PUBLISHED. Gli insegnanti del corso e gli amministratori di dominio possono visualizzare tutto il materiale didattico 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 in caso di errori di accesso.
  • INVALID_ARGUMENT se la richiesta non è in un formato corretto.
  • NOT_FOUND se il corso richiesto non esiste.

Richiesta HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials

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.

Parametri di query

Parametri
courseWorkMaterialStates[]

enum (CourseWorkMaterialState)

Restrizione sullo stato del lavoro da restituire. Viene restituito solo il materiale didattico del corso corrispondente. Se non è specificato, vengono restituiti gli elementi con uno stato del lavoro PUBLISHED.

orderBy

string

Ordinamento facoltativo dei risultati. Un elenco separato da virgole di campi con una parola chiave di ordinamento facoltativa. Il campo supportato è updateTime. Le parole chiave di direzione supportate sono asc e desc. Se non è specificato, il comportamento predefinito è updateTime desc. Esempi: updateTime asc, updateTime

pageSize

integer

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

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

pageToken

string

Il 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.

materialDriveId

string

Filtro facoltativo per il materiale didattico del corso con almeno un materiale di Drive il cui ID corrisponde alla stringa fornita. Se viene specificato anche materialLink, il materiale didattico del corso deve avere materiali che corrispondono a entrambi i filtri.

previewVersion

enum (PreviewVersion)

Facoltativo. La versione di anteprima dell'API. Questa opzione deve essere impostata per accedere alle nuove funzionalità dell'API rese disponibili agli sviluppatori nel Programma Anteprima.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta quando si elenca il materiale didattico del corso.

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

Rappresentazione JSON
{
  "courseWorkMaterial": [
    {
      object (CourseWorkMaterial)
    }
  ],
  "nextPageToken": string
}
Campi
courseWorkMaterial[]

object (CourseWorkMaterial)

Elementi di materiale didattico del corso che corrispondono alla richiesta.

nextPageToken

string

Token che identifica la pagina successiva di risultati da restituire. Se è vuoto, non sono disponibili altri risultati.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/classroom.courseworkmaterials
  • https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly

Per ulteriori informazioni, consulta la guida all'autorizzazione.