Method: courses.updateGradingPeriodSettings
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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:
gradingPeriodsapplyToExistingCoursework 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.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[],[],null,["# Method: courses.updateGradingPeriodSettings\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates grading period settings of a course.\n\nIndividual grading periods can be added, removed, or modified using this method.\n\nThe requesting user and course owner must be eligible to modify Grading Periods. For details, see [licensing requirements](https://developers.google.com/workspace/classroom/grading-periods/manage-grading-periods#licensing_requirements).\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to modify the grading period settings in a course or for [access errors](/workspace/classroom/reference/Access.Errors):\n - UserIneligibleToUpdateGradingPeriodSettings\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if the requested course does not exist.\n\n### HTTP request\n\n`PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|--------------------------------------------------|\n| `courseId` | `string` Required. The identifier of the course. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Mask that identifies which fields in the GradingPeriodSettings to update. The GradingPeriodSettings `gradingPeriods` list will be fully replaced by the grading periods specified in the update request. For example: - Grading periods included in the list without an ID are considered additions, and a new ID will be assigned when the request is made. - Grading periods that currently exist, but are missing from the request will be considered deletions. - Grading periods with an existing ID and modified data are considered edits. Unmodified data will be left as is. - Grading periods included with an unknown ID will result in an error. The following fields may be specified: - `gradingPeriods` - `applyToExistingCoursework` This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Optional. The preview version of the API. This must be set in order to access new API capabilities made available to developers in the Preview Program. |\n\n### Request body\n\nThe request body contains an instance of [GradingPeriodSettings](/workspace/classroom/reference/rest/v1/GradingPeriodSettings).\n\n### Response body\n\nIf successful, the response body contains an instance of [GradingPeriodSettings](/workspace/classroom/reference/rest/v1/GradingPeriodSettings).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.courses`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
