Method: courses.studentGroups.list

Restituisce un elenco di gruppi in un corso.

Questo metodo restituisce i seguenti codici di errore:

  • NOT_FOUND se il corso non esiste.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
courseId

string

Obbligatorio. L'identificatore del corso.

Parametri di query

Parametri
pageSize

integer

Il numero massimo di elementi da restituire. Il valore zero o non specificato indica che il server può assegnare un valore massimo, attualmente impostato su 75 elementi.

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

string

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

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

enum (PreviewVersion)

Facoltativo. La versione di anteprima dell'API. Questa impostazione è necessaria per accedere alle nuove funzionalità API rese disponibili agli sviluppatori nel programma di anteprima.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta quando vengono elencati i gruppi di studenti.

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

Rappresentazione JSON 
{
  "studentGroups": [
    {
      object (StudentGroup)
    }
  ],
  "nextPageToken": string
}
Campi
studentGroups[]

object (StudentGroup)

I gruppi di studenti.
nextPageToken

string

Token che identifica la pagina dei 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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.