Method: courses.updateGradingPeriodSettings

Aggiorna le impostazioni del periodo di valutazione di un corso.

I singoli periodi di valutazione possono essere aggiunti, rimossi o modificati utilizzando questo metodo.

L'utente che effettua la richiesta e il proprietario del corso devono avere l'idoneità a modificare i periodi di valutazione. Per maggiori dettagli, consulta i requisiti di licenza.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente che effettua la richiesta non è autorizzato a modificare le impostazioni del periodo di valutazione in un corso o per 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 verrà assegnato un nuovo ID al momento della richiesta.
  • I periodi di valutazione esistenti, ma mancanti nella richiesta, verranno considerati eliminazioni.
  • I periodi di valutazione con un ID esistente e dati modificati sono considerati modifiche. I dati non modificati rimarranno invariati.
  • I periodi di valutazione inclusi con un ID sconosciuto causeranno un errore.

È possibile specificare i seguenti campi:

  • gradingPeriods
  • applyToExistingCoursework

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

enum (PreviewVersion)

Facoltativo. La versione di anteprima dell'API. Questo valore deve essere impostato per accedere alle nuove funzionalità dell'API rese disponibili per gli sviluppatori nel Programma di 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.