Domande frequenti

Visualizzare, creare e modificare i lavori del corso in Classroom

Cosa posso creare con gli endpoint CourseWork nell'API Classroom?

Gli endpoint consentono agli sviluppatori di visualizzare e gestire i lavori di un corso. Nello specifico, puoi eseguire tutte le seguenti operazioni:

  • Visualizza i compiti e le domande (definiti collettivamente CourseWork) per un utente.
  • Creare, modificare ed eliminare CourseWork.
  • Allega materiali (file di Drive, video di YouTube, link) a CourseWork.
  • Modificare lo stato dell'invio di uno studente (ad esempio consegna, restituzione, recupero).
  • Imposta il voto per l'invio di un compito.
  • Allegare materiali (file di Drive, video di YouTube, link) ai compiti inviati dagli studenti.

Alcuni casi d'uso di esempio per CourseWork:

  • I registri, i sistemi SIS o di report possono sincronizzare compiti e voti da Classroom alle loro applicazioni, eliminando il trasferimento manuale dei dati.
  • Le applicazioni di apprendimento possono creare nuovi compiti che vengono visualizzati nello stream del corso. Man mano che gli studenti completano il lavoro, le applicazioni possono consegnarlo, impostare i voti, allegare il lavoro degli studenti e archiviarlo nelle cartelle Drive appropriate.
  • Gli utenti insegnanti possono creare compiti con allegati aggiuntivi dal tuo sito web o dalla tua applicazione.
  • Gli studenti possono consegnare i compiti con gli allegati del tuo componente aggiuntivo.

Quali autorizzazioni deve avere la mia applicazione per creare o modificare i compiti?

In genere, un'applicazione può modificare solo il lavoro che crea. In altre parole, qualsiasi richiesta API per modificare CourseWork deve utilizzare lo stesso ID progetto Google Cloud utilizzato per creare CourseWork.

I componenti aggiuntivi di Google Classroom fanno eccezione a questa regola. Un progetto Cloud può accedere o modificare qualsiasi annuncio, compito o materiale che contenga uno o più dei suoi allegati del componente aggiuntivo. Un progetto Cloud può anche consegnare, rivendicare o restituire un compito che contiene uno o più allegati dei suoi componenti aggiuntivi.

Le richieste API richiedono anche gli ambiti utente corretti. Gli insegnanti possono visualizzare i compiti, creare compiti, allegare link ai compiti consegnati e impostare i voti dei compiti consegnati. Gli studenti possono visualizzare i compiti, allegare link ai propri registri dei compiti e consegnare e recuperare i propri invii. Gli amministratori di dominio possono visualizzare CourseWork, ma non hanno autorizzazioni di scrittura.

Quali tipi di elementi può allegare la mia applicazione a compiti o invii?

L'API supporta l'allegato di file di Drive, video di YouTube e link. L'allegato di moduli Google nativi non è ancora supportato.

Gli utenti finali sanno che un compito in Classroom è stato creato dalla mia applicazione?

Sì. L'interfaccia utente di Classroom identifica i compiti creati esternamente utilizzando il nome del prodotto del progetto Google Cloud che ha creato il lavoro. Gli utenti possono segnalare il lavoro creato esternamente come indesiderato, nonché disconnettere l'applicazione che ha creato il lavoro revocando le credenziali rilasciate all'applicazione dall'utente.

Pulsante Condividi di Classroom e altre integrazioni

Ho già eseguito l'integrazione con il pulsante di condivisione di Classroom. Posso modificare un compito creato utilizzando il pulsante di condivisione?

Non ancora. Per modificare un'assegnazione, la richiesta deve utilizzare lo stesso progetto Google Cloud che ha creato l'assegnazione.

Posso rispondere alle domande nell'API?

Non ancora. Puoi creare e modificare le domande.

Componenti aggiuntivi di Classroom

Configurazione progetto

Posso convertire un progetto Google Cloud privato che ho utilizzato durante lo sviluppo in un progetto pubblico che posso utilizzare in produzione?

No, non puoi convertire un progetto Google Cloud privato in uno pubblico. Devi avere due progetti separati, uno per lo sviluppo e l'altro per la produzione.

Un singolo progetto Google Cloud può avere due schede di Google Workspace Marketplace?

No. Non puoi creare due schede Google Workspace Marketplace per un singolo progetto Google Cloud.

Tuttavia, è possibile raggruppare i componenti aggiuntivi. In questo modo, un singolo elenco di Google Workspace Marketplace può rappresentare più componenti aggiuntivi. L'installazione da una scheda di questo tipo installerebbe tutti i componenti aggiuntivi del pacchetto contemporaneamente. Durante l'autorizzazione, gli utenti devono acconsentire a tutti gli ambiti necessari per i componenti aggiuntivi in bundle.

È possibile riutilizzare un client OAuth di un altro progetto Google Cloud con un progetto Google Cloud per i componenti aggiuntivi di Classroom?

No, un client OAuth di un progetto Google Cloud diverso da quello del componente aggiuntivo Classroom non può funzionare. I token di accesso generati da un altro progetto Google Cloud vengono rifiutati dall'API Classroom. Devi creare un client OAuth separato per il progetto del componente aggiuntivo.

Esperienza utente

Il nostro logo non si adatta bene a un piccolo quadrato. Quali opzioni di dimensioni sono disponibili per i loghi nella barra del titolo dell'iframe dei componenti aggiuntivi di Classroom?

La barra del titolo dell'iframe è stata progettata per supportare solo un logo quadrato 32x32. Questa scelta è stata fatta per corrispondere alla forma della favicon che le aziende utilizzano sui propri siti web ed è nostra indicazione utilizzare lo stesso logo nello spazio per coerenza del brand.

Domini

Tutti gli insegnanti e gli studenti dello stesso dominio hanno accesso a un componente aggiuntivo installato?

Gli amministratori di dominio possono controllare quali insegnanti possono visualizzare un componente aggiuntivo installato. I componenti aggiuntivi di Classroom possono essere utilizzati solo dagli utenti con la licenza Teaching & Learning o Education Plus.

In che modo gli amministratori di dominio interagiscono con i componenti aggiuntivi?

Gli amministratori di dominio controllano chi può utilizzare il tuo componente aggiuntivo. Possono installare un componente aggiuntivo per un intero dominio utilizzando l'opzione di installazione dell'amministratore. Se il tuo componente aggiuntivo può essere installato singolarmente, tieni presente che la maggior parte degli amministratori gestisce una lista consentita di componenti aggiuntivi; gli insegnanti inclusi in questo elenco possono installare i componenti aggiuntivi per proprio conto. Un amministratore potrebbe anche scegliere di installare individualmente il tuo componente aggiuntivo a scopo di test.

Gli amministratori potrebbero essere interessati anche alle statistiche di utilizzo relative al tuo componente aggiuntivo. Se supportato dal tuo prodotto, valuta la possibilità di fornire statistiche sull'utilizzo dei componenti aggiuntivi in una visualizzazione amministratore sul tuo sito.

API

Qual è un modo affidabile per sapere se i contenuti dei componenti aggiuntivi vengono caricati all'interno di un iframe o di una nuova scheda?

Al momento non esiste un metodo per distinguere le due tipologie.

Quali elementi di lavoro assegnabili ricevono un iframe di revisione del lavoro dello studente?

L'iframe Revisione del lavoro dello studente viene fornito solo per gli allegati di tipo attività. Chiama il metodo courses.courseWork.getAddOnContext per scoprire se il tipo di post supporta il lavoro degli studenti. Il campo supportsStudentWork può essere true solo per un tipo di post che è un'attività.

Un allegato del componente aggiuntivo può accedere all'elemento del flusso a cui è allegato?

Sì. Puoi get o patch qualsiasi Announcement, CourseWork o CourseWorkMaterial che contenga almeno uno degli allegati dei tuoi componenti aggiuntivi. Puoi reclaim, return o turnIn un CourseWork StudentSubmission.

Single Sign-On

Sì, possono continuare a utilizzare Google Sign-In.

Ogni studente ha un indirizzo email formato correttamente anche se non ha accesso a Gmail?

Ogni utente di Google Workspace for Education ha un'identità Google, indipendentemente dal fatto che abbia accesso a Gmail. L'identità e l'accesso a qualsiasi servizio Google specifico (incluso Gmail) sono distinti. Anche se Gmail è disattivato, gli studenti possono accedere a Classroom con il proprio indirizzo email. Le identità sono rappresentate da un ID utente e un indirizzo email. Un utente di Google Workspace for Education può modificare il proprio indirizzo email, pertanto ti consigliamo di utilizzare gli ID utente come chiavi primarie quando memorizzi le informazioni utente.

Un amministratore della scuola deve preapprovare l'app per consentire agli studenti di accedere?

Gli amministratori di dominio devono inserire nella lista consentita un componente aggiuntivo prima che possa essere installato. Facoltativamente, gli amministratori di dominio possono installare un componente aggiuntivo per tutti gli utenti all'interno del dominio o di un'unità organizzativa.

Feedback e domande generali

Come posso inviare richieste di funzionalità o segnalare problemi?

Puoi inviare, visualizzare e votare le richieste di funzionalità nel nostro strumento Issue Tracker pubblico.

Come faccio a sapere quando sono disponibili nuove funzionalità nell'API Classroom?

Gli aggiornamenti dell'API vengono pubblicati nella newsletter per gli sviluppatori e nello strumento pubblico di monitoraggio dei problemi.

Utilizzo l'API Classroom. Come faccio a porre domande tecniche?

Pubblica le tue domande su Stack Overflow con il tag google-classroom.