L'API Google Classroom fornisce un'interfaccia di programmazione per sviluppatori di software, amministratori e dirigenti scolastici per gestire le risorse di Google Classroom. Puoi creare software che creano, recuperano e modificano i corsi di Classroom e i relativi contenuti.
Alcuni casi d'uso tipici includono:
- Gestire corsi, elenchi degli studenti e tutori
- Aggiungere compiti, annunci e materiali del corso
- Assegnare i voti e modificare le impostazioni di valutazione
- Generazione di dati per l'analisi
- Rendere rilevabili e accessibili contenuti o strumenti di un fornitore 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 al 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. Ho familiarità con la scrittura di codice e la manutenzione dell'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 overhead minimo. | Utilizza l'API Classroom con Google Apps Script. |
| Voglio apportare occasionalmente modifiche alle singole risorse di Classroom. Ho dimestichezza con i comandi del terminale. | Utilizza Google Apps Manager. |
| Voglio un volume elevato di report con dettagli sugli eventi in Classroom. | Utilizza BigQuery Data Transfer Service. |
| 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 avviano i miei contenuti in Classroom. | Crea un componente aggiuntivo di Classroom. |
| Voglio che gli insegnanti facciano clic su un pulsante del mio sito web o della 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 del mio sito web o della mia app per collegarsi ai miei contenuti in Classroom. | Crea compiti utilizzando l'API Classroom o incorpora i pulsanti Condividi con Classroom. |
| Voglio che gli insegnanti di Classroom sincronizzino o importino le informazioni dal mio sistema informatico per gli studenti. | Implementa OneRoster per il SIS o crea e accedi alle risorse utilizzando l'API Classroom. |
Per iniziare
I nuovi sviluppatori sono invitati a svolgere le seguenti operazioni prima di iniziare un nuovo progetto:
- Leggi la nostra guida sulla struttura dell'API Classroom.
- Scopri di più su livelli, tipi di utenti, idoneità degli utenti e azioni dell'amministratore. Queste guide spiegano i concetti unici di Google Classroom e dell'API Classroom.
- Scopri come funzionano le richieste API Classroom.
Per iniziare lo sviluppo, assicurati di aver completato i passaggi preliminari. Scegli gli ambiti dell'API Classroom appropriati per le tue esigenze, quindi configura l'ambiente e inizia a effettuare richieste seguendo una delle guide rapide:
Eseguire esperimenti con Explorer API di Google
Per provare a chiamare metodi su dati live, utilizza Explorer API di Google. Per iniziare non devi scrivere alcun codice, ma tieni presente che le azioni che esegui utilizzando APIs Explorer 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 corsi, puoi crearne uno utilizzando il metodo
courses.create().
Puoi anche esplorare il riferimento API Classroom.