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. Per testare l'integrazione, potresti anche dover ottenere l'accesso a Google Classroom. 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. Non è necessario utilizzare funzionalità Google Cloud a pagamento per utilizzare l'API Classroom.

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: anche se gli account Gmail standard possono accedere a Google Classroom, è necessario un dominio di prova se stai tentando di testare comportamenti che si applicano solo agli utenti di Google Workspace for Education, ad esempio funzionalità amministrative speciali.

I domini di prova 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 reali.

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 testare solo le autorizzazioni di amministratore dell'API. Sono incluse, ad esempio, la creazione di corsi per conto degli insegnanti.

Per utilizzare l'ambiente predefinito, 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 di Google Workspace for Education predefinito, che può essere utilizzato per demo dei clienti, risoluzione dei problemi relativi ai prodotti, test delle funzionalità e altro ancora.

Ottenere un dominio demo per sviluppatori

Per effettuare richieste per conto di utenti insegnanti e studenti, devi creare e gestire il tuo dominio demo Google Workspace for Education. I domini di prova includono una licenza permanente e senza costi di Google Workspace for Education Fundamentals. È possibile aggiungere altri prodotti al dominio in base alle esigenze.

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 di prova devono avere questo formato.
2. Verifica di essere il proprietario del dominio demo.

3. Registrati a Google Workspace for Education utilizzando il dominio di prova. Inizia così un periodo di prova di due settimane.

   Importante: il nuovo dominio deve essere un dominio Google Workspace principale. Ciò significa che il dominio demo non può essere un sottodominio di un dominio Google Workspace esistente, noto come dominio secondario. 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.

4. Compila questo modulo per notificare a Google la registrazione del tuo dominio. Tutte le richieste di domini di prova vengono esaminate da un Partner Manager.

5. Se stai sviluppando un'integrazione che utilizza le 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 agisca come insegnante e due studenti.

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

Nota: ti consigliamo di creare profili separati per gli utenti del tuo dominio demo in modo da poterli cambiare rapidamente durante l'utilizzo del dominio demo.

Richiedere un upgrade del dominio demo per le funzionalità premium

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

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

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

Per l'elenco completo delle funzionalità disponibili a ogni livello di abbonamento, consulta la pagina Licenze di Google Workspace for Education.

Se la tua integrazione utilizzerà una di queste funzionalità, completa i passaggi riportati di seguito per richiedere un upgrade del dominio demo. A un 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. Se non l'hai ancora fatto, completa i passaggi per ottenere un dominio dimostrativo per gli sviluppatori.
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 di prova a Google Workspace for Education Plus con dieci licenza.
3. Al termine del processo di upgrade, riceverai un'email.
4. Assegna le licenze Plus agli account degli insegnanti di prova nel dominio demo sottoposto ad upgrade nella Console di amministrazione.
   1. In Directory > Utenti, crea o seleziona gli account degli insegnanti di prova.
   2. In Licenze di ciascun insegnante, verifica che Google Workspace for Education Plus sia Assegnato.