L'API Google Classroom è un'interfaccia di programmazione che consente a sviluppatori di software, amministratori e dirigenti scolastici di gestire le risorse di Google Classroom. Puoi creare un software che crea, recupera e modifica i corsi di Classroom e i relativi contenuti.
Alcuni casi d'uso tipici includono:
- Gestione di corsi, elenchi degli studenti e tutori
- Aggiungere compiti, annunci e materiali del corso
- Assegnare voti e modificare le impostazioni di valutazione
- Generazione di dati per l'analisi
- Rendere visibili e accessibili contenuti o strumenti di un provider esterno all'interno di Classroom
L'API Classroom è la soluzione giusta per me?
Google offre diversi prodotti per aiutarti a interagire con Classroom. Di seguito sono riportati alcuni scenari comuni e consigli sui prodotti che potrebbero soddisfare meglio le tue esigenze.
Modificare le risorse di Google Classroom
| Scenario | Soluzioni consigliate |
|---|---|
| Voglio gestire regolarmente un volume elevato di corsi, utenti o altre risorse di Classroom. Mi sento a mio agio a scrivere codice e a gestire l'infrastruttura software. | Scrivi applicazioni che utilizzano l'API Classroom. |
| Voglio gestire occasionalmente un piccolo volume di risorse di Classroom. Mi sento a mio agio a scrivere piccole quantità di codice con un'occupazione ridotta. | Utilizza l'API Classroom con Google Apps Script. |
| Voglio apportare occasionalmente modifiche a singole risorse di Classroom. Sono a mio agio con i comandi del terminale. | Utilizza Google Apps Manager. |
| Voglio ricevere un volume elevato di report con i dettagli sugli eventi in Classroom. | Utilizza Data Transfer Service di BigQuery. |
| Voglio condurre un'indagine sull'attività dei miei utenti. | Genera report nella Console di amministrazione o utilizza l'API Reports. |
Eseguire l'integrazione con Google Classroom
| Scenario | Soluzioni consigliate |
|---|---|
| Voglio che insegnanti e studenti vedano e lancino i miei contenuti in Classroom. | Crea un componente aggiuntivo di Classroom. |
| Voglio che gli insegnanti facciano clic su un pulsante sul mio sito web o sulla mia app che incorpora i miei contenuti in Classroom. | Crea un componente aggiuntivo di Classroom e crea allegati in modo programmatico. |
| Voglio che gli insegnanti facciano clic su un pulsante sul mio sito web o nella mia app per collegare i miei contenuti in Classroom. | Crea materiale didattico utilizzando l'API Classroom o incorporando i pulsanti Condividi con Classroom. |
| Voglio che gli insegnanti di Classroom sincronizzino o importino informazioni dal mio sistema informatico per gli studenti. | Implementa OneRoster per SIS o crea e accedi alle risorse utilizzando l'API Classroom. |
Per iniziare
I nuovi sviluppatori sono invitati a svolgere i seguenti passaggi prima di iniziare un nuovo progetto:
- Leggi la nostra guida sulla struttura dell'API Classroom.
- Scopri di più su valutazioni, tipi di utenti, idoneità degli utenti e azioni dell'amministratore. Queste guide spiegano i concetti specifici di Google Classroom e dell'API Classroom.
- Scopri come funzionano le richieste dell'API Classroom.
Per iniziare a sviluppare, assicurati di aver completato i passaggi preliminari. Scegli gli ambiti dell'API Classroom appropriati per le tue esigenze, quindi configura il tuo ambiente e inizia a inviare richieste seguendo una delle guide rapide:
Sperimenta con Explorer API di Google
Per sperimentare i metodi di chiamata sui dati in tempo reale, prova a utilizzare Explorer API di Google. Per iniziare non è necessario scrivere codice, ma tieni presente che le azioni eseguite utilizzando Esplora API possono modificare i dati esistenti.
Un modo per iniziare a chiamare i metodi è chiamare il metodo courses.list(). Questo metodo non richiede parametri di richiesta e puoi recuperare un id dall'elenco dei corsi restituito da utilizzare come parametro di richiesta per altre chiamate API. Se non hai ancora corsi, puoi crearne uno utilizzando il metodo
courses.create().
Puoi anche consultare il riferimento all'API Classroom.