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.