Method: courses.updateGradingPeriodSettings

Aggiorna le impostazioni del periodo di valutazione di un corso.

L'utente richiedente e il proprietario del corso devono disporre di una licenza supportata. Consulta i requisiti di licenza.

Questo metodo restituisce i seguenti codici di errore:

  • PERMISSION_DENIED se l'utente che ha inviato la richiesta non dispone dell'autorizzazione per 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

Obbligatoria. L'identificatore del corso.

Parametri di ricerca

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)

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