Method: courses.students.list

Restituisce un elenco di studenti di questo corso che il richiedente è autorizzato a visualizzare.

Questo metodo restituisce i seguenti codici di errore:

Richiesta HTTP

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

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
pageSize

integer

Il numero massimo di elementi da restituire. Il valore predefinito è 30 se non specificato o 0.

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.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta quando vengono elencati gli studenti.

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

Rappresentazione JSON
{
  "students": [
    {
      object (Student)
    }
  ],
  "nextPageToken": string
}
Campi
students[]

object (Student)

Gli studenti che corrispondono alla richiesta dell'elenco.

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.rosters
  • https://www.googleapis.com/auth/classroom.rosters.readonly
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

Per ulteriori informazioni, consulta la Guida all'autorizzazione.