Method: courses.patch

Consente di aggiornare uno o più campi di un corso.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente che ha inviato la richiesta non è autorizzato a modificare il corso richiesto o per errori di accesso.
  • NOT_FOUND se non esiste nessun 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

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 ricerca

Parametri
updateMask

string (FieldMask format)

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

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

Nota: le patch a ownerId vengono considerate immediatamente effettive, ma in pratica potrebbe essere necessario un po' di tempo per il completamento del trasferimento della proprietà di tutte le risorse interessate.

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 alle autorizzazioni.