Method: courses.studentGroups.patch

Aggiorna uno o più campi in un gruppo di studenti.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente richiedente non è autorizzato a modificare il gruppo di studenti richiesto o per errori di accesso.
  • NOT_FOUND se il gruppo di studenti non esiste o l'utente non ha accesso al gruppo di studenti.
  • INVALID_ARGUMENT se nella maschera di aggiornamento sono specificati campi non validi o se non viene fornita alcuna maschera di aggiornamento.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
courseId

string

Obbligatorio. L'identificatore del corso.
id

string

Obbligatorio. Identificatore del gruppo di studenti.

Parametri di query

Parametri
updateMask

string (FieldMask format)

Obbligatorio. Maschera che identifica i campi del gruppo di studenti da aggiornare. Questo campo è obbligatorio per eseguire un aggiornamento. L'aggiornamento non riesce se vengono specificati campi non validi.

I seguenti campi possono essere specificati dagli insegnanti:

  • title

Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Facoltativo. La versione di anteprima dell'endpoint. Questa impostazione è necessaria 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 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.