Method: courses.patch

Aggiorna uno o più campi di un corso.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente che effettua la richiesta non è autorizzato a modificare il corso richiesto o per errori di accesso.
  • NOT_FOUND se non esiste alcun corso con l'ID richiesto.
  • INVALID_ARGUMENT se nella maschera di aggiornamento sono specificati campi non validi o se non viene fornita alcuna maschera di aggiornamento.
  • FAILED_PRECONDITION per i seguenti errori di richiesta:
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
id

string

Identificatore del corso da aggiornare. Questo identificatore può essere l'identificatore assegnato da Classroom o un alias.

Parametri di query

Parametri
updateMask

string (FieldMask format)

Maschera che identifica i campi del corso da aggiornare. Questo campo è obbligatorio per eseguire un aggiornamento. L'aggiornamento non andrà a buon fine se vengono specificati campi non validi. I seguenti campi sono validi:

  • name
  • section
  • descriptionHeading
  • description
  • room
  • courseState
  • ownerId

Nota: le patch a ownerId vengono trattate come immediatamente applicabili, ma in pratica il completamento del trasferimento della proprietà di tutte le risorse interessate potrebbe richiedere del tempo.

Se impostato in un parametro di query, questo campo deve essere specificato come

updateMask=<field1>,<field2>,...

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

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Course.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Course.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.