Method: courses.updateGradingPeriodSettings

Aggiorna le impostazioni del periodo di valutazione di un corso.

L'utente che ha inviato la richiesta e il proprietario del corso devono essere idonei a modificare i periodi di valutazione. Per maggiori dettagli, consulta i requisiti per le licenze.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente che ha inviato la richiesta non è autorizzato a modificare le impostazioni del periodo di valutazione in un corso o per gli errori di accesso:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT se la richiesta non è valida.
  • NOT_FOUND se il corso richiesto non esiste.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
courseId

string

Obbligatorio. L'identificatore del corso.

Parametri di query

Parametri
updateMask

string (FieldMask format)

Maschera che identifica i campi di GradingPeriodSettings da aggiornare.

L'elenco GradingPeriodSettings gradingPeriods verrà completamente sostituito dai periodi di valutazione specificati nella richiesta di aggiornamento. Ad esempio:

  • I periodi di valutazione inclusi nell'elenco senza un ID sono considerati aggiunte e un nuovo ID verrà assegnato quando viene effettuata la richiesta.
  • I periodi di valutazione attualmente esistenti, ma mancanti nella richiesta saranno considerati eliminazioni.
  • I periodi di valutazione con un ID esistente e dati modificati sono considerati modifiche. I dati non modificati verranno lasciati invariati.
  • I periodi di valutazione inclusi con un ID sconosciuto restituiranno un errore.

È possibile specificare i seguenti campi:

  • gradingPeriods
  • applyToExistingCoursework

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

previewVersion

enum (PreviewVersion)

(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 GradingPeriodSettings.

Corpo della risposta

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.