Method: courses.patch

Aggiorna uno o più campi in 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 in caso di errori di accesso.
  • NOT_FOUND se non esiste un corso con l'ID richiesto.
  • INVALID_ARGUMENT se nella maschera di aggiornamento vengono specificati campi non validi o se non viene fornita alcuna maschera di aggiornamento.
  • FAILED_PRECONDITION per i seguenti errori di richiesta:
    • CourseNotModifiable
    • InactiveCourseOwner
    • IneligibleOwner
    • CourseTitleCannotContainUrl

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
id

string

L'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:

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

Nota: le patch a ownerId vengono trattate come se fossero effettive immediatamente, 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.