Method: courses.checkGradingPeriodsSetupEligibility

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.