Qualsiasi sviluppatore può inviare richieste all'API Google Classroom, ma 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.
Funzionalità con requisiti di idoneità
Le seguenti funzionalità dell'API Classroom sono disponibili solo per gli utenti idonei:
- Creare allegati dei componenti aggiuntivi di Classroom
- Modificare le impostazioni del periodo di valutazione
Determinare le funzionalità utente
Le richieste all'API Classroom vengono effettuate per conto dei singoli utenti. Pertanto, devi verificare se un utente dispone delle funzionalità appropriate prima di inviare richieste API con requisiti di idoneità.
Per determinare se un utente ha una funzionalità particolare, effettua una richiesta API al
metodo checkUserCapability. Includi il tipo di Capability appropriato
per la funzionalità di Classroom che intendi utilizzare. Specifica il valore Capability appropriato per ogni funzionalità:
- Per verificare se l'utente ha accesso a un componente aggiuntivo di Classroom di proprietà del progetto Google Cloud che effettua la richiesta, passa il valore
CREATE_ADD_ON_ATTACHMENT. - Per verificare se l'utente può modificare le impostazioni del periodo di valutazione, passa il valore
UPDATE_GRADING_PERIOD_SETTINGS.
Poi controlla il campo allowed nella risposta. Se allowed è true, l'utente ha accesso al Capability scelto. A questo punto puoi inviare richieste API
relative al Capability per conto dell'utente.