Method: userProfiles.checkUserCapability

• Richiesta HTTP
• Parametri del percorso
• Parametri di ricerca
• Corpo della richiesta
• Corpo della risposta
  • Rappresentazione JSON
• Ambiti di autorizzazione
• Capacità

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_20240930_PREVIEW e versioni successive. Per saperne di più, consulta Accedere alle API di anteprima.

Restituisce se un utente può utilizzare la funzionalità di Classroom specificata. Ad esempio, questo endpoint può essere utilizzato per verificare se un utente può creare allegati dei componenti aggiuntivi.

Un utente che ha inviato la richiesta può verificare solo personalmente le funzionalità.

Questo metodo restituisce i seguenti codici di errore:

• PERMISSION_DENIED se l'utente che ha inviato la richiesta non è autorizzato a verificare l'idoneità per l'utente specificato.
• INVALID_ARGUMENT se la richiesta non è valida.

Richiesta HTTP

GET https://classroom.googleapis.com/v1/userProfiles/{userId}:checkUserCapability

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
userId	string Obbligatorio. Identificatore dell'utente. Se specificato come parametro di una richiesta, questo identificatore può essere uno dei seguenti: l'identificatore numerico dell'utente l'indirizzo email dell'utente la stringa letterale "me", che indica l'utente che effettua la richiesta

Parametri di query

Parametri
capability	enum (Capability) Obbligatorio. La funzionalità da controllare per questo utente. Ad esempio, per verificare se un utente può creare un allegato del componente aggiuntivo, imposta questo valore su CREATE_ADD_ON_ATTACHMENT.
previewVersion	enum (PreviewVersion) (Facoltativo) La versione di anteprima dell'API.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta dal controllo delle funzionalità dell'utente.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{ "capability": enum (Capability), "allowed": boolean }

Campi
capability	enum (Capability) La funzionalità di Classroom.
allowed	boolean Indica se la funzionalità specificata è consentita per l'utente.

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.

Capacità

Enum per rappresentare la funzionalità.

Enum
CAPABILITY_UNSPECIFIED	Non supportati.
CREATE_ADD_ON_ATTACHMENT	La possibilità di creare e modificare gli elementi AddOnAttachments associati al progetto della Console per gli sviluppatori dell'ID client OAuth utilizzato per effettuare la richiesta.
UPDATE_GRADING_PERIOD_SETTINGS	La possibilità di modificare le impostazioni del periodo di valutazione.