Method: courses.studentGroups.create

Crea un gruppo di studenti per un corso.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente richiedente non è autorizzato a creare il gruppo di studenti o per errori di accesso.
  • NOT_FOUND se il corso non esiste o l'utente richiedente non ha accesso al corso.
  • FAILED_PRECONDITION se la creazione del gruppo di studenti supererebbe il numero massimo di gruppi di studenti per corso.

Richiesta HTTP

POST 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
previewVersion

enum (PreviewVersion)

Facoltativo. La versione di anteprima dell'API. Questo valore deve essere impostato per accedere alle nuove funzionalità API rese disponibili agli sviluppatori nel programma di anteprima.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di StudentGroup.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza appena creata di StudentGroup.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/classroom.rosters

Per ulteriori informazioni, consulta la Guida all'autorizzazione.