Domande frequenti (FAQ)

Visualizzazione, creazione e modifica dei lavori del corso in Classroom

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

I nuovi endpoint consentono agli sviluppatori di visualizzare e gestire il lavoro di un corso. Nello specifico, puoi eseguire tutte le seguenti operazioni:

  • Visualizzare i compiti e le domande (collettivamente denominati "CourseWork") per un utente
  • Creare, modificare ed eliminare CourseWork
  • Allega materiali (file di Drive, video di YouTube, link) a CourseWork
  • Modificare lo stato dei contenuti inviati da uno studente (ad esempio, consegna, restituzione, ritiro)
  • Impostare il voto per l'invio di un compito
  • Allega materiali (file di Drive, video di YouTube, link) ai contenuti inviati dagli studenti

Alcuni esempi di casi d'uso di CourseWork:

  • Registri, SIS o sistemi di generazione dei report possono sincronizzare compiti e voti da Classroom alle relative applicazioni, eliminando il trasferimento manuale dei dati
  • Le applicazioni di apprendimento possono creare nuovi compiti che vengono visualizzati nel flusso del corso. Man mano che gli studenti completano il lavoro, le applicazioni possono consegnarlo, impostare i voti, allegare i lavori degli studenti e archiviarli nelle cartelle di Drive appropriate.
  • Gli utenti insegnanti possono creare compiti con allegati aggiuntivi dal sito web o dall'applicazione.
  • Gli utenti studenti possono consegnare i compiti che hanno i tuoi allegati aggiuntivi.

Quali autorizzazioni occorrono all'applicazione per creare o modificare i compiti?

In genere, un'applicazione può modificare solo il lavoro creato. In altre parole, tutte le richieste API di mutazione dell'assegnazione devono utilizzare lo stesso ID progetto Google Cloud archiviato al momento della creazione dell'assegnazione.

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ù allegati del componente aggiuntivo. Un progetto Cloud può anche consegnare, rivendicare o restituire un compito che contiene uno o più allegati di componenti aggiuntivi.

Le richieste API richiedono anche gli ambiti utente corretti. Gli insegnanti possono visualizzare i compiti, creare compiti, allegare i link ai compiti inviati e impostare i voti dei compiti. Gli studenti possono visualizzare i compiti, allegare link ai record dei compiti e consegnare e ritirare i contenuti inviati. Gli amministratori di dominio possono visualizzare CourseWork, ma non dispongono di autorizzazioni di scrittura.

Quali tipi di elementi posso allegare alla mia candidatura a compiti o invii?

L'API supporta l'aggiunta di file di Drive, video di YouTube e link. Non è ancora possibile allegare moduli Google nativi.

Gli utenti finali sanno che la mia applicazione ha creato un compito in Classroom?

Sì. La UI 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 le opere create esternamente come indesiderate, nonché disconnettere l'applicazione che l'ha creata, revocando qualsiasi credenziale inviata all'applicazione dall'utente.

Pulsante di condivisione in Classroom e altre integrazioni

Ho già integrato il pulsante di condivisione di Classroom. Posso modificare un compito creato utilizzando il pulsante Condividi?

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. Rispondere alle domande a livello di programmazione è già nostra.

Componenti aggiuntivi di Classroom

Configurazione progetto

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

Non puoi convertire un progetto Google Cloud privato in uno pubblico. Sono necessari due progetti separati, uno per lo sviluppo e l'altro per la produzione.

Un singolo progetto Google Cloud può avere due schede GWM?

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

Tuttavia, è possibile raggruppare i componenti aggiuntivi. In questo modo una singola scheda GWM può rappresentare più componenti aggiuntivi. L'installazione da una scheda di questo tipo comporta l'installazione contemporanea di tutti i componenti aggiuntivi del bundle. Gli utenti devono dare il consenso a tutti gli ambiti necessari dai componenti aggiuntivi in bundle al momento dell'autorizzazione.

Esistono altre due considerazioni relative al raggruppamento:

  1. I componenti aggiuntivi di Classroom sono disponibili solo per gli utenti abbonati con Teaching & Learning Upgrade o con lo SKU Education Plus.

  2. L'API dei componenti aggiuntivi è in accesso in anteprima ed è limitata agli sviluppatori partecipanti e ai progetti Google Cloud. I componenti aggiuntivi in bundle potrebbero non funzionare come previsto se si basano su progetti Google Cloud non partecipanti.

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 quadrato piccolo. Quali sono le dimensioni disponibili per i loghi nella barra del titolo dell'iframe?

La barra del titolo dell'iframe è stata progettata per supportare solo un logo quadrato di 32 x 32. Questa scelta è stata fatta in base alla forma della favicon utilizzata dalle aziende sui loro siti web ed è nostra guida a utilizzare lo stesso logo nello spazio per garantire la coerenza del brand.

Domini

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

Gli amministratori scolastici hanno la possibilità di controllare quali insegnanti possono visualizzare un componente aggiuntivo installato.

Come interagiscono gli amministratori di dominio con i componenti aggiuntivi?

Gli amministratori di dominio (amministratori) stabiliscono chi può utilizzare il componente aggiuntivo. Possono installare un componente aggiuntivo per un intero dominio utilizzando l'opzione di installazione dell'amministratore. Se il componente aggiuntivo può essere installato singolarmente, tieni presente che la maggior parte degli amministratori gestisce una lista consentita di componenti aggiuntivi; gli insegnanti possono installare i componenti aggiuntivi per se stessi presenti nell'elenco. Un amministratore potrebbe anche scegliere di installare singolarmente il componente aggiuntivo a scopo di test.

Gli amministratori potrebbero anche essere interessati alle statistiche sull'utilizzo relative al tuo componente aggiuntivo. Se la funzionalità è supportata dal tuo prodotto, puoi fornire statistiche sull'utilizzo dei componenti aggiuntivi nella visualizzazione amministratore del tuo sito.

API

Qual è un modo affidabile per sapere se la pagina del partner viene caricata all'interno di un iframe o di una scheda popout?

Al momento non esiste un metodo per distinguere tra i due.

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

L'iframe della recensione del lavoro dello studente viene fornito solo per gli allegati di tipo attività. Chiama il metodo courses.courseWork.getAddOnContext per rivelare 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à.

Potrebbero verificarsi modifiche che provocano un errore nell'API durante il programma di accesso in anteprima?

L'API dei componenti aggiuntivi è ancora in fase di sviluppo. Pertanto, potrebbero verificarsi modifiche che provocano errori nell'API, causando l'esito negativo o diverso delle richieste precedentemente riuscite. In caso di modifiche che provocano un errore, puoi ricevere in anticipo una notifica tramite il forum degli sviluppatori.

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 contiene almeno uno degli allegati del componente aggiuntivo. Puoi reclaim, return o turnIn a CourseWork StudentSubmission.

Quando verranno rilasciati pubblicamente i componenti aggiuntivi di Classroom?

I componenti aggiuntivi di Classroom sono disponibili per tutti gli utenti finali dall'estate del 2022. L'API dei componenti aggiuntivi dovrebbe essere disponibile a livello generale per gli sviluppatori nel 2024.

Single Sign-On

Sì, può comunque usare Accedi con Google.

Ogni studente ha un indirizzo email formulato 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. Le identità sono rappresentate da un indirizzo email. L'identità e l'accesso a un servizio Google specifico (incluso Gmail) sono distinti. Pertanto, anche se Gmail è disattivato, gli utenti studenti possono accedere con il loro indirizzo email.

L'amministratore scolastico 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 richieste di problemi?

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

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

Gli aggiornamenti dell'API sono pubblicati nella pagina delle note di rilascio, nel nostro forum per gli sviluppatori e nell'Issue Tracker pubblico.

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

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