Method: courses.updateGradingPeriodSettings

• Richiesta HTTP
• Parametri del percorso
• Parametri di ricerca
• Corpo della richiesta
• Corpo della risposta
• Ambiti di autorizzazione

Anteprima per sviluppatori: disponibile nell'ambito del programma Anteprima per sviluppatori di Google Workspace, che concede l'accesso in anteprima a determinate funzionalità. Questa funzionalità è disponibile in V1_20240401_PREVIEW e versioni successive. Per saperne di più, consulta Accedere alle API di anteprima.

Aggiorna le impostazioni del periodo di valutazione di un corso.

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

Questo metodo restituisce i seguenti codici di errore:

• PERMISSION_DENIED se all'utente che effettua la richiesta non è consentito 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.