Prerequisiti

Tutte le integrazioni di Google Workspace dipendono da Google Cloud per configurare l'accesso alle API, gestire l'autenticazione e l'autorizzazione e gestire le applicazioni. Potresti anche dover ottenere l'accesso a Google Classroom per testare l'integrazione. Questa guida descrive come richiedere e configurare queste risorse.

Configura un progetto Google Cloud

Punto chiave: devi utilizzare un progetto Google Cloud per gestire un'integrazione di Google Classroom. Per utilizzare l'API Classroom non è necessario utilizzare funzionalità Google Cloud a pagamento.

Completa i passaggi per iniziare per gli sviluppatori di Google Workspace. Questi passaggi sono obbligatori per tutte le integrazioni di Google Workspace.

Account e domini di test

Punto chiave: sebbene gli account Gmail standard possano accedere a Google Classroom, avrai bisogno di un dominio demo se tenti di testare comportamenti che si applicano solo agli utenti di Google Workspace for Education, come le funzionalità speciali di amministratore.

I domini demo sono account di test per le integrazioni dell'API Classroom. Un dominio demo rappresenta una scuola fittizia con un abbonamento a Google Workspace for Education che puoi utilizzare per sviluppare e testare le integrazioni senza influire sugli utenti attivi.

Puoi ottenere un dominio di test per testare le funzionalità di amministratore o per lo sviluppo con l'API Classroom.

Ottenere un dominio di prova amministrativo

Puoi utilizzare un ambiente demo predefinito se devi solo testare le autorizzazioni di amministratore dell'API. Ciò include, ad esempio, la creazione di corsi per conto degli insegnanti.

Per utilizzare l'ambiente preconfigurato, partecipa al programma Partner Advantage di Google Cloud. I membri hanno accesso alla pagina Google for Education di Partner Advantage. Questa pagina descrive come accedere al nostro ambiente demo predefinito di Google Workspace for Education, che può essere utilizzato per demo per i clienti, risoluzione dei problemi dei prodotti, test delle funzionalità e altro ancora.

Ottenere un dominio demo per sviluppatori

Per effettuare richieste per conto di insegnanti e studenti, devi creare e gestire il tuo dominio demo di Google Workspace for Education. I domini demo includono una licenza di Google Workspace for Education Fundamentals senza costi e permanente. Se necessario, è possibile aggiungere altri prodotti al dominio.

Completa i seguenti passaggi per ottenere un dominio demo per sviluppatori.

1. Acquista un dominio nel formato gedu.demo.YOUR DOMAIN. Ad esempio, un'organizzazione che gestisce il dominio myedtech.com deve creare gedu.demo.myedtech.com. I domini demo devono seguire questo formato.

2. Registrati a Google Workspace for Education utilizzando il dominio demo. Inizia un periodo di prova di due settimane.

   Importante: il nuovo dominio deve essere un dominio Google Workspace principale. Ciò significa che il tuo dominio demo non può essere un sottodominio di un dominio Google Workspace esistente, che vengono chiamati domini secondari. Google non può concedere una licenza demo a un dominio secondario. Per ulteriori informazioni sulla gestione dei domini utilizzati per Google Workspace, consulta gli articoli del Centro assistenza Scegliere il dominio principale e Cambiare il dominio principale.
   Attenzione: non aspettare. Completa i seguenti passaggi il prima possibile dopo l'inizio del periodo di prova di due settimane. Possiamo intervenire solo sugli abbonamenti a Google Workspace for Education attivi.

3. Verifica di essere il proprietario del dominio demo.

4. Compila questo modulo per comunicare a Google la registrazione del tuo dominio.

5. Se stai sviluppando un'integrazione che utilizza funzionalità a pagamento di Google Classroom, richiedi un upgrade del dominio demo.

6. Accedi alla Console di amministrazione Google utilizzando l'account amministratore specificato durante la registrazione a Google Workspace for Education. Da qui, crea nuovi utenti del dominio demo. Ti consigliamo di creare almeno tre utenti aggiuntivi: uno che funga da insegnante e due studenti.

7. Accedi a Google Classroom utilizzando un nuovo account insegnante. Crea un nuovo corso e aggiungi i nuovi account studente.

Suggerimento: crea profili Chrome separati per gli utenti del dominio demo in modo da poter passare rapidamente da uno all'altro mentre utilizzi il dominio demo.

Richiedi l'upgrade di un dominio demo per le funzionalità premium

Punto chiave: alcune funzionalità di Google Classroom richiedono una licenza Google Workspace for Education a pagamento. Richiedi un upgrade per il tuo dominio demo per poter testare un'integrazione che si basa su queste funzionalità.

Per utilizzare le integrazioni che influiscono o dipendono dalle funzionalità premium di Classroom, gli utenti devono disporre di una licenza Google Workspace for Education appropriata. Queste funzionalità includono:

• Componenti aggiuntivi di Classroom
• Periodi di valutazione
• Scale di valutazione
• Esportazione dei voti
• Sincronizzazione dell'elenco degli studenti
• Griglie

Consulta la pagina Licenze Google Workspace for Education per l'elenco completo delle funzionalità disponibili per ogni livello di abbonamento.

Se la tua integrazione utilizzerà una di queste funzionalità, completa i seguenti passaggi per richiedere l'upgrade di un dominio demo. Al dominio di cui è stato eseguito l'upgrade verranno concesse dieci licenze Google Workspace for Education Plus senza costi da assegnare agli utenti di test.

1. Completa i passaggi per ottenere un dominio demo per sviluppatori se non l'hai ancora fatto.
2. Compila e invia il modulo di richiesta di upgrade del dominio demo. L'invio di questo modulo richiede a Google di eseguire l'upgrade del tuo dominio demo a Google Workspace for Education Plus con dieci licenze.
3. Riceverai un'email al termine della procedura di upgrade.
4. Assegna le licenze Plus agli account insegnante di prova nella Console di amministrazione del dominio demo di cui è stato eseguito l'upgrade.
   1. In Directory > Utenti, crea o seleziona i tuoi account insegnante di test.
   2. In Licenze di ogni insegnante, verifica che Google Workspace for Education Plus sia Assegnato.