Visualizzare, creare e modificare le attività 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. In particolare, puoi effettuare tutte le seguenti operazioni:
- Visualizzare i compiti e le domande (collettivamente indicati come
CourseWork) per un utente - Crea, modifica ed elimina
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, rivendicazione)
- Impostare il voto per l'invio di un compito
- Allega materiali (file di Drive, video di YouTube, link) a compiti consegnati dagli studenti
Alcuni casi d'uso di esempio per CourseWork:
- I registri, il SIS o i sistemi di generazione dei report possono sincronizzare i compiti e i voti da Classroom alle proprie applicazioni, eliminando i dati manuali trasferimento
- Le applicazioni di apprendimento possono creare nuovi compiti che vengono visualizzati nel corso flusso di dati. Mentre gli studenti completano il lavoro, le applicazioni possono consegnarlo, impostare i voti, allegare i lavori degli studenti e archiviarli nei Cartelle di Drive.
- Gli insegnanti possono creare compiti con allegati aggiuntivi dal tuo sito web o all'applicazione.
- Gli utenti studenti possono consegnare i compiti che hanno il tuo componente aggiuntivo allegati.
Quali autorizzazioni ha bisogno la mia applicazione per creare o modificare assegnazioni?
In genere, un'applicazione può modificare solo il lavoro creato. In altre parole, tutte le richieste API di mutazione delle assegnazioni devono utilizzare lo stesso ID progetto Google Cloud che archiviato al momento della creazione del compito.
I componenti aggiuntivi di Google Classroom fanno un'eccezione a questa regola. R Il progetto Cloud può accedere o modificare qualsiasi annuncio, compito materiale che ha uno o più dei relativi allegati aggiuntivi. R Il progetto cloud può anche consegnare, recuperare o restituire un compito ha uno o più allegati dei componenti aggiuntivi.
Le richieste API richiedono anche gli ambiti utente corretti. Gli insegnanti possono visualizzare
compiti, creare compiti, allegare link ai compiti inviati e impostare
i voti inviati. Gli studenti possono visualizzare i compiti e allegare link ai loro
dei compiti, consegnare e ritirare i contenuti inviati. Dominio
Gli amministratori possono visualizzare CourseWork, ma non hanno autorizzazioni di scrittura.
Quali tipi di elementi posso allegare la mia domanda ai compiti o agli invii?
L'API supporta l'aggiunta di file di Drive, video di YouTube e . Non è ancora possibile allegare moduli Google nativi.
Gli utenti finali sanno che un compito in Classroom è stato creato dalla mia applicazione?
Sì. L'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 il lavoro creato esternamente come indesiderato, nonché scollegare l'applicazione che ha creato l'opera, revocando qualsiasi credenziale concessa al dell'applicazione da parte dell'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 con il pulsante Condividi?
Non ancora. Per modificare un'assegnazione, la richiesta deve usare lo stesso account progetto che ha creato il compito.
Posso rispondere alle domande nell'API?
Non ancora. Puoi creare e modificare domande. Risposta alle domande in modo programmatico è sulla nostra roadmap.
Componenti aggiuntivi di Classroom
Configurazione progetto
Posso convertire un progetto Google Cloud privato che ho utilizzato durante lo sviluppo in un progetto pubblico da utilizzare in produzione?
Non puoi convertire un progetto Google Cloud privato in uno pubblico. Ti servono due 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 di Google Workspace Marketplace per un un singolo progetto Google Cloud.
Tuttavia, è possibile raggruppare i componenti aggiuntivi. In questo modo, un singolo scheda di Google Workspace Marketplace per rappresentare più componenti aggiuntivi. Installazione... da una scheda di questo tipo installeranno tutti i componenti aggiuntivi del bundle all'indirizzo una volta sola. Gli utenti devono acconsentire a tutti gli ambiti necessari per i componenti aggiuntivi in bundle al momento dell'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 Il progetto Google Cloud del componente aggiuntivo di Classroom non funziona. Token di accesso generate da un altro progetto Google Cloud vengono negate 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 opzioni di dimensioni sono disponibili per i loghi nella barra del titolo dell'iframe?
La barra del titolo dell'iframe è stata progettata per supportare solo un logo quadrato da 32 x 32. Questo è stata fatta una scelta in base alla forma della favicon che le aziende utilizzano sui loro siti web ed è nostra indicazione di 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 stabilire quali insegnanti possono visualizzare installato. I componenti aggiuntivi di Classroom possono essere utilizzati solo dagli utenti con un programma Learning o la licenza Education Plus.
In che modo gli amministratori di dominio interagiscono 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 il programma di installazione . Se il componente aggiuntivo può essere installato singolarmente, tieni presente che la maggior parte Gli amministratori gestiscono una lista consentita dei componenti aggiuntivi. gli insegnanti possono installare componenti aggiuntivi presenti in questo elenco. Un amministratore potrebbe anche decidere di installare singolarmente il componente aggiuntivo a scopo di test.
Gli amministratori potrebbero essere interessati anche alle statistiche sull'utilizzo relative ai tuoi come componente aggiuntivo. Se la funzionalità è supportata dal tuo prodotto, ti consigliamo di 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 distinguerli.
Quali elementi di lavoro assegnabili ricevono un iframe per la revisione del lavoro dello studente?
L'iframe della revisione del lavoro dello studente viene fornito solo per gli allegati di tipo attività.
Chiama il metodo courses.courseWork.getAddOnContext per scoprire se il post
supporta il lavoro degli studenti. Il campo supportsStudentWork può essere solo true
per un tipo di post che è un'attività.
Un allegato di un componente aggiuntivo può accedere all'elemento dello stream a cui è collegato?
Sì. Puoi get o patch qualsiasi Announcement, CourseWork oppure
CourseWorkMaterial che contiene almeno uno degli allegati del componente aggiuntivo.
Puoi reclaim, return o turnIn per CourseWork StudentSubmission.
Single Sign-On
Gli studenti che usano i badge Clever o Classlink per accedere al proprio Chromebook possono usare Accedi con Google?
Sì, può continuare a usare Accedi con Google.
Tutti gli studenti hanno un indirizzo email formulato correttamente, anche se non hanno accesso a Gmail?
Ogni utente di Google Workspace for Education ha un'identità Google, indipendentemente se hanno accesso a Gmail. Le identità sono rappresentate da un indirizzo email . Identità e accesso a un servizio Google specifico (incluso Gmail) sono distinti. Quindi, anche se Gmail è disattivato, gli utenti studenti possono accedere con il proprio indirizzo email.
L'amministratore scolastico deve pre-approvare 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 dominio o a un'unità organizzativa.
Feedback e domande generali
Come faccio a inviare richieste di funzionalità o problemi relativi alle richieste?
Puoi inviare, visualizzare e votare le richieste di funzionalità nella nostra questione pubblica tracker.
Come faccio a sapere quando sono disponibili nuove funzionalità nell'API Classroom?
Gli aggiornamenti dell'API vengono pubblicati sulla pagina delle note di rilascio del nostro forum per gli sviluppatori e Issue Tracker pubblico.
sto usando l'API Classroom. Come faccio a porre domande tecniche?
Pubblica le tue domande su Stack Overflow usando il tag google-classroom.