Method: courses.patch

Aggiorna uno o più campi di un corso.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente richiedente 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 vengono specificati campi non validi nella maschera di aggiornamento 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 riuscirà se vengono specificati campi non validi. Sono validi i seguenti campi:

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

Nota: le patch per ownerId vengono trattate come se fossero effettive immediatamente, ma in pratica potrebbe essere necessario del tempo prima che il trasferimento della proprietà di tutte le risorse interessate venga completato.

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.