Method: courses.courseWork.patch

Aggiorna uno o più campi del lavoro di un corso.

Consulta la google.classroom.v1.CourseWork per informazioni dettagliate su quali campi possono essere aggiornati e su chi può modificarli.

Questa richiesta deve essere effettuata dal progetto Developer Console dell'ID client OAuth utilizzato per creare l'elemento di lavoro del corso corrispondente.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se il progetto dello sviluppatore richiedente non ha creato i lavori del corso corrispondenti, se all'utente non è consentito apportare le modifiche richieste ai contenuti inviati dallo studente o in caso di errori di accesso.
  • INVALID_ARGUMENT se la richiesta non è valida.
  • FAILED_PRECONDITION se il lavoro del corso richiesto è già stato eliminato.
  • NOT_FOUND se il corso o il lavoro richiesto non esiste.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
courseId

string

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

string

Identificatore del lavoro del corso.

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 va a buon fine. Se un campo supporta valori vuoti, può essere cancellato specificandolo nella maschera di aggiornamento e non nell'oggetto CourseWork. Se un campo che non supporta valori vuoti è incluso nella maschera di aggiornamento e non è impostato nell'oggetto CourseWork, viene restituito un errore INVALID_ARGUMENT.

I seguenti campi possono essere specificati dagli insegnanti:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId Disponibile in V1_20240401_PREVIEW e versioni successive.

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

enum (PreviewVersion)

Campo facoltativo. La versione di anteprima dell'API. Questa impostazione deve essere impostata per accedere alle nuove funzionalità dell'API messe a disposizione degli sviluppatori nel Programma Anteprima.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di CourseWork.

Corpo della risposta

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/classroom.coursework.students

Per ulteriori informazioni, consulta la Guida all'autorizzazione.