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 in un corso. In particolare, puoi eseguire tutte le seguenti operazioni:

  • Visualizzare i compiti e le domande (collettivamente denominati CourseWork) per un utente.
  • Creare, modificare ed eliminare CourseWork.
  • Allegare materiali (file di Drive, video di YouTube, link) a CourseWork.
  • Modificare lo stato dell'invio di uno studente (ad esempio consegna, restituzione, recupero).
  • Impostare il voto per l'invio di un compito.
  • Allegare materiali (file di Drive, video di YouTube, link) agli invii degli studenti.

Alcuni esempi di casi d'uso per CourseWork:

  • I registri dei voti, i sistemi informativi per gli studenti (SIS) o i sistemi di reportistica possono sincronizzare i compiti e i 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. Quando gli studenti completano il lavoro, le applicazioni possono consegnarlo, impostare i voti, allegare il lavoro degli studenti e archiviarlo nelle cartelle di Drive appropriate.
  • Gli insegnanti possono creare compiti con allegati di componenti aggiuntivi dal tuo sito web o dalla tua applicazione.
  • Gli studenti possono consegnare i compiti che contengono gli allegati dei tuoi componenti aggiuntivi.

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, tutte le richieste API per modificare CourseWork devono utilizzare lo stesso ID progetto Google Cloud utilizzato per creare CourseWork.

I componenti aggiuntivi di Google Classroom hanno un'eccezione a questa regola. Un progetto Cloud può accedere o modificare qualsiasi annuncio, compito o materiale che contenga uno o più allegati dei suoi componenti aggiuntivi. Un progetto Cloud può anche consegnare, recuperare 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 agli invii dei compiti e impostare i voti degli invii. Gli studenti possono visualizzare i compiti, allegare link ai record dei compiti e consegnare e recuperare i loro invii. Gli amministratori di dominio possono visualizzare CourseWork, ma non hanno autorizzazioni in scrittura.

Quali tipi di elementi può allegare la mia applicazione ai compiti o agli 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 i lavori creati esternamente come indesiderati, nonché disconnettere l'applicazione che ha creato il lavoro revocando le credenziali rilasciate all'applicazione dall'utente.

Pulsante di condivisione 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 compito, la richiesta deve utilizzare lo stesso progetto Google Cloud che ha creato il compito.

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. Ti servono due progetti separati, uno per lo sviluppo e l'altro per la produzione.

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

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

Tuttavia, è possibile raggruppare i componenti aggiuntivi. In questo modo, una singola scheda del Google Workspace Marketplace può rappresentare più componenti aggiuntivi. L'installazione da una scheda di questo tipo installerebbe tutti i componenti aggiuntivi del pacchetto contemporaneamente. Gli utenti dovranno dare il consenso a tutti gli ambiti richiesti dai componenti aggiuntivi raggruppati durante l'autorizzazione.

Un client OAuth di un altro progetto Google Cloud può essere riutilizzato con un progetto Google Cloud per i componenti aggiuntivi di Classroom?

No, un client OAuth di un progetto Google Cloud diverso dal progetto Google Cloud del componente aggiuntivo di 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 del favicon che le aziende utilizzano sui loro siti web e ti consigliamo di utilizzare lo stesso logo nello spazio per la coerenza del brand.

Domini

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

Gli amministratori di dominio hanno la possibilità di controllare quali insegnanti possono vedere un componente aggiuntivo installato. I componenti aggiuntivi di Classroom sono utilizzabili 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 installazione opzione. 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 questa lista possono installare i componenti aggiuntivi per conto proprio. Un amministratore potrebbe anche scegliere di installare singolarmente il tuo componente aggiuntivo a scopo di test.

Gli amministratori potrebbero anche essere interessati alle statistiche di utilizzo relative al tuo componente aggiuntivo. Se il tuo prodotto lo supporta, valuta la possibilità di fornire statistiche di utilizzo dei componenti aggiuntivi in una visualizzazione dell'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 tra i due.

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

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

Un allegato di un componente aggiuntivo può accedere all'elemento dello stream 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 comunque utilizzare l'accesso con Google.

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 un determinato servizio Google (incluso Gmail) sono distinti. Anche se Gmail è disattivato, gli studenti possono accedere a Classroom con il loro indirizzo email. Le identità sono rappresentate da un ID utente e da 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 pre-approvare l'app per consentire agli studenti di accedere?

Gli amministratori di dominio devono inserire un componente aggiuntivo nella lista consentita 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 Issue Tracker pubblico.

Sto utilizzando l'API Classroom. Come posso fare domande tecniche?

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