Idoneità degli utenti

Sebbene qualsiasi sviluppatore possa inviare richieste all'API Google Classroom, alcune funzionalità di Google Classroom sono disponibili solo per determinati utenti. Ogni funzionalità può avere requisiti diversi, ad esempio la presenza di un determinato tipo di licenza Google Workspace for Education. Per un'analisi dettagliata delle funzionalità a ogni livello di licenza di Google Workspace for Education, consulta la pagina di confronto delle versioni.

Termine chiave: un utente idoneo ha la funzionalità di utilizzare una determinata funzionalità di Classroom se soddisfa i requisiti della funzionalità.

Punto chiave: la funzionalità viene determinata separatamente per ogni utente e può cambiare nel tempo. L'idoneità delle funzionalità per alcune funzionalità dell'API Classroom potrebbe essere diversa da quella delle funzionalità corrispondenti nell'app Google Classroom. Ad esempio, per la creazione, la modifica o l'eliminazione delle rubriche con l'API si applicano determinati requisiti di licenza.

Funzionalità con requisiti di idoneità

Le seguenti funzionalità dell'API Classroom sono disponibili solo per gli utenti idonei:

• Creazione e modifica degli allegati dei componenti aggiuntivi di Classroom.
• Modifica delle impostazioni del periodo di valutazione.
• Creazione, modifica ed eliminazione di griglie.

Determinare le funzionalità utente

Le richieste all'API Classroom vengono effettuate per conto di singoli utenti. Pertanto, devi verificare se un utente dispone delle funzionalità appropriate prima di emettere richieste API con requisiti di idoneità.

Punto chiave :ti consigliamo di controllare in modo proattivo le funzionalità degli utenti per personalizzare l'aspetto o il comportamento del tuo prodotto in base alle funzionalità di Classroom a cui possono accedere.

Per determinare se un utente dispone di una determinata funzionalità, invia una richiesta API al metodo checkUserCapability. Includi il tipo Capability appropriato per la funzionalità di Classroom che intendi utilizzare. Specifica il valore Capability appropriato per ogni funzionalità:

Per verificare se l'utente…	Capability
Può creare o modificare un allegato del componente aggiuntivo di Classroom associato al progetto Google Cloud dell'ID client OAuth utilizzato per effettuare la richiesta	CREATE_ADD_ON_ATTACHMENT
Può modificare le impostazioni del periodo di valutazione	UPDATE_GRADING_PERIOD_SETTINGS
Può creare, modificare o eliminare una griglia	CREATE_RUBRIC

Poi controlla il campo allowed nella risposta. Se allowed è true, l'utente ha accesso al Capability scelto. A questo punto puoi effettuare richieste API relative a Capability per conto dell'utente.

Importante: anche se un utente è idoneo, è comunque possibile che le richieste API che dipendono dall'idoneità non vadano a buon fine. L'idoneità implica che un utente può utilizzare una funzionalità di Classroom, non che una richiesta specifica andrà a buon fine.