Method: courses.checkGradingPeriodsSetupEligibility
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Restituisce se un utente è idoneo ad aggiornare GradingPeriodSettings in un determinato corso.Questo metodo è deprecato. Utilizza invece UserProfiles.checkUserCapability
Questo metodo restituisce i seguenti codici di errore:
PERMISSION_DENIED per errori di accesso.INVALID_ARGUMENT se la richiesta non è valida.NOT_FOUND se il corso richiesto non esiste.
Richiesta HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}:checkGradingPeriodsSetupEligibility
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
courseId |
string
Obbligatorio. L'identificatore del corso.
|
Parametri di query
| Parametri |
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 deve essere vuoto.
Corpo della risposta
Indica se l'utente è autorizzato ad aggiornare GradingPeriodSettings in questo corso.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"courseId": string,
"isGradingPeriodsSetupEligible": boolean,
"previewVersion": enum (PreviewVersion)
} |
| Campi |
courseId |
string
Immutabile. L'identificatore del corso.
|
isGradingPeriodsSetupEligible |
boolean
Indica se l'utente è autorizzato ad aggiornare le impostazioni GradingPeriodSettings in questo corso.
|
previewVersion |
enum (PreviewVersion)
Solo output. 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.
|
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/classroom.courses
https://www.googleapis.com/auth/classroom.courses.readonly
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.checkGradingPeriodsSetupEligibility\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 - [JSON representation](#body.CheckGradingPeriodsSetupEligibilityResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\n| This item is deprecated!\n\u003cbr /\u003e\n\n| **Developer Preview:** Available as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), which grants early access to certain features. This feature is available in [V1_20240401_PREVIEW](https://developers.google.com/workspace/classroom/reference/rest/v1/PreviewVersion) and later. See [Access Preview APIs](https://developers.google.com/workspace/classroom/reference/preview) to learn more.\nReturns whether a user is eligible to update GradingPeriodSettings in a given course.\n\n\u003cbr /\u003e\n\nThis method is deprecated. Use [`UserProfiles.checkUserCapability`](/workspace/classroom/reference/rest/v1/userProfiles/checkUserCapability#body.PATH_PARAMETERS.user_id) instead.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if the requested course does not exist.\n\n### HTTP request\n\n`GET https://classroom.googleapis.com/v1/courses/{courseId}:checkGradingPeriodsSetupEligibility`\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| `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 must be empty.\n\n### Response body\n\nWhether the user is allowed to update GradingPeriodSettings in this course.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"courseId\": string, \"isGradingPeriodsSetupEligible\": boolean, \"previewVersion\": enum (/workspace/classroom/reference/rest/v1/PreviewVersion) } ``` |\n\n| Fields ||\n|---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Immutable. The identifier of the course. |\n| `isGradingPeriodsSetupEligible` | `boolean` Whether the user is allowed to update the GradingPeriodSettings in this course. |\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Output only. 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### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/classroom.courses`\n- `\n https://www.googleapis.com/auth/classroom.courses.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
