Percorso dello sviluppatore

Di seguito è riportata una rapida panoramica dei passaggi da seguire per sviluppare un componente aggiuntivo di Classroom.

Onboarding

  1. Sono necessari utenti di test con la versione Teaching & Learning o Plus di Google Workspace for Education. Se non disponi dell'accesso come amministratore a un dominio Google Workspace for Education con una di queste licenze, completa la procedura per ottenere un dominio di prova sviluppatore, quindi invia il nostro modulo di richiesta di upgrade del dominio. Nel dominio verrà eseguito il provisioning di 10 licenze Google Workspace for Education Plus.
  2. Creare un progetto Google Cloud. Potrai quindi configurare il tuo componente aggiuntivo, effettuare richieste API e autenticare e autorizzare gli utenti. Puoi usare anche un progetto Cloud esistente.

  3. Crea account di insegnanti e studenti per i test. Una volta approvata la licenza per il tuo dominio demo, assegna utenze a ciascuno dei tuoi account di prova.

  4. Configura OAuth per il tuo progetto.

  5. Crea una scheda di Google Workspace Marketplace per il progetto demo.

    • Se imposti Visibilità dell'app su pubblica, aggiungi gli indirizzi email di tutti gli utenti di test all'elenco dei tester di bozze. Al termine, scegli SALVA BOZZA.
  6. Accedi al tuo dominio demo come utente di prova. Installa il componente aggiuntivo dall'URL dell'app nella configurazione della scheda di Google Workspace Marketplace.

Sviluppo

  1. Sviluppa il componente aggiuntivo e testalo con i tester di test.

In fase di pubblicazione

  1. Nel progetto Google Cloud che vuoi pubblicare, verifica quanto segue:
    1. Schermata per il consenso OAuth:
      1. Tipo di utente: esterno
      2. Stato pubblicazione: in produzione
      3. Ambiti: configura tutti gli ambiti richiesti dall'app web.
    2. Schermata di configurazione dell'app dell'SDK di Google Workspace Marketplace:
      1. Visibilità dell'app: pubblica
      2. Tipo scheda: Non in elenco
      3. Ambiti: configura tutti gli ambiti richiesti dall'app web.
  2. Crea un elenco di Google Workspace Marketplace per il progetto pubblico. Aggiungi i tuoi account utente di test come tester delle bozze dell'SDK Marketplace. Salva le modifiche come bozza. Se non vedi l'opzione Bozza, registra il progetto al Programma Anteprima per gli sviluppatori di Google Workspace.
  3. Aggiorna il progetto pubblico con il codice del componente aggiuntivo.
  4. Poiché sei uno dei tester di bozze, installa il componente aggiuntivo visitando l' URL della scheda del Marketplace.
  5. Invia una richiesta di verifica OAuth per il tuo progetto pubblico. Dovrai registrare un breve video che mostri l'utilizzo degli ambiti dei componenti aggiuntivi utilizzando uno degli account tester di bozze.
  6. Pubblica il componente aggiuntivo pubblico per la revisione nel Marketplace.
  7. Una volta ottenuta l'approvazione, cambia lo stato della scheda dell'SDK Marketplace in elencato.

Integrazioni richieste

Per creare un componente aggiuntivo di Classroom è necessario quanto segue.

  1. Single Sign-On con Google

    Consulta la pagina di accesso senza problemi per informazioni su come implementare l'accesso seguendo le best practice.

  2. Invio a Google Workspace Marketplace come componente aggiuntivo di Classroom

  3. Implementazioni di iframe

Google Workspace Marketplace

Google Workspace Marketplace presenta le applicazioni aziendali che possono essere aggiunte a un intero dominio o a singoli account Google Workspace. Marketplace è integrato nella Console di amministrazione Google per consentire agli amministratori di dominio di trovare, installare e autorizzare rapidamente le app per gli utenti target.

Alcuni concetti chiave con cui avere familiarità sono: