Procedura di revisione

Questa guida descrive la procedura di revisione per i componenti aggiuntivi di Classroom. Leggila attentamente, perché ci sono azioni urgenti che devi eseguire.

Il componente aggiuntivo deve essere verificato tramite OAuth dal team Trust &Safety e approvato dal team di Google Workspace Marketplace. Per informazioni generali sulla verifica OAuth, consulta le Domande frequenti sulla verifica OAuth. Per informazioni generali sulla procedura di revisione delle app di Google Workspace Marketplace, consulta Informazioni sulla revisione delle app.

Finalizzare lo sviluppo del componente aggiuntivo

Esaminare i requisiti del componente aggiuntivo

Verifica che il comportamento del componente aggiuntivo soddisfi i requisiti.

Testare il componente aggiuntivo

Il componente aggiuntivo viene esaminato in base alle procedure descritte nel nostro piano di test dei componenti aggiuntivi. Segui le procedure di test con il componente aggiuntivo pubblico prima di inviarlo per la pubblicazione. Gli errori in questi test possono aumentare notevolmente il tempo necessario per l'approvazione del componente aggiuntivo.

Registrare un video dimostrativo

Crea una registrazione dello schermo che mostri come la tua applicazione utilizza ogni ambito OAuth richiesto. Ai fini dello sviluppo di un componente aggiuntivo, ti consigliamo di mostrare il flusso di installazione del componente aggiuntivo e la creazione di un allegato del componente aggiuntivo.

Una volta registrata, carica la registrazione dello schermo su YouTube come un non in elenco video su YouTube. Un video non in elenco può essere raggiunto solo tramite il suo link. Ti verrà chiesto il link del video quando avvii la procedura di verifica OAuth. Il team OAuth visualizza il video durante la revisione della richiesta del componente aggiuntivo.

Prepararsi alla pubblicazione

Controllare la configurazione del progetto Cloud

Esamina ciascuna delle seguenti impostazioni di configurazione nel tuo progetto Google Cloud.

  • Nella pagina Pubblico di autenticazione del progetto Cloud:
    • Lo stato di pubblicazione è In produzione.
    • Il tipo di utente è Esterno.
  • Nella pagina Branding di autenticazione del progetto Cloud:
    • Tutti i campi obbligatori sono stati completati.
    • Assicurati che la home page dell'applicazione non rimandi all'app stessa, ma alle informazioni sui tuoi prodotti.
  • Nella pagina Accesso ai dati di autenticazione del progetto Cloud:
    • È specificato almeno uno degli ambit0/} o .../auth/userinfo.profile non sensibili i..../auth/userinfo.email
    • Sono specificati tutti gli altri ambiti richiesti dal componente aggiuntivo. Per i componenti aggiuntivi di Classroom, devono essere inclusi gli ambiti sensibili .../auth/classroom.addons.teacher e.../auth/classroom.addons.student.
    • Nel campo Video dimostrativo devi fornire un link a un video di YouTube che mostri come utilizzi i dati degli ambiti richiesti. Fornisci il link alla registrazione dello schermo registrata in precedenza.
  • Le seguenti librerie API sono attivate:

Controllare le impostazioni dell'SDK Marketplace

Nella pagina Configurazione dell'app dell'SDK di Google Workspace Marketplace:

  • In Integrazione dell'app è selezionato Componente aggiuntivo di Classroom.
  • L'URI di destinazione del componente aggiuntivo è fornito in URI di configurazione allegati.
  • Sono forniti tutti i prefissi URI dell'allegato consentiti.
  • L'elenco degli ambiti OAuth corrisponde esattamente agli ambiti specificati nella schermata per il consenso OAuth e nel codice dell'applicazione.
  • L'indirizzo email dello sviluppatore in Link dello sviluppatore è un indirizzo email monitorato regolarmente. Il team di Marketplace utilizza questo indirizzo per comunicare con te.
  • La visibilità dell'app è impostata su Pubblico e la Non in elenco casella è selezionata.

Verifica che la pagina della scheda dello Store di Google Workspace Marketplace del tuo progetto sia conforme alle Considerazioni sulla scheda.

Consentire l'accesso al revisore

Consenti ai seguenti account utente del team di revisione di Marketplace di accedere alla tua applicazione. Aggiungi anche i due utenti insegnanti come Tester di bozze per la richiesta del componente aggiuntivo.

  • teacher@marketplacetest.info
  • teacher2@marketplacetest.info
  • student@marketplacetest.info
  • student2@marketplacetest.info

Riceverai un'email dal team di Marketplace quando inizierà la revisione. Se i revisori devono eseguire dei passaggi di configurazione per utilizzare questi account con il tuo prodotto, rispondi all'email fornendo istruzioni dettagliate.

Completare la verifica OAuth

Inviare per la verifica

Il team Trust & Safety deve verificare che il componente aggiuntivo utilizzi correttamente gli ambiti OAuth richiesti dall'applicazione. Avvia la verifica dal Centro di verifica dell'autenticazione del tuo progetto Google Cloud. Fai clic su Preparati per la verifica.

Una finestra di dialogo di conferma elenca i valori configurati nelle pagine Branding di autenticazione, Pubblico e Accesso ai dati. Verifica che le informazioni siano corrette, quindi fai clic su Conferma per continuare.

Comunicare con il team di verifica

Il team di verifica OAuth elabora la tua richiesta di verifica. I revisori comunicano con te utilizzando gli indirizzi email configurati nella schermata per il consenso OAuth. Ti informeranno di eventuali dubbi e del completamento della verifica.

In genere, questa procedura richiede 3-5 giorni lavorativi se utilizzi solo Ambiti OAuth sensibili. Se utilizzi Ambiti OAuth con restrizioni, potrebbero essere necessari più tempo e azioni aggiuntive.

Completare la revisione di Google Workspace Marketplace

Inviare per la revisione

Fai clic su PUBBLICA nella parte inferiore della pagina della scheda dello Store di Google Workspace Marketplace del tuo progetto Google Cloud. Il team di revisione di Marketplace testa il componente aggiuntivo in base ai requisiti dei componenti aggiuntivi di Google Workspace e Classroom.

Comunicare con il team di revisione

Il team di revisione di Marketplace comunica direttamente con l'indirizzo email dello sviluppatore specificato nella pagina Configurazione dell'app dell'SDK di Google Workspace Marketplace. Riceverai una notifica in caso di dubbi sul componente aggiuntivo o per informarti che è stato approvato per la pubblicazione. Ti consigliamo di prevedere 2-3 settimane per questa procedura.

Dopo l'approvazione della pubblicazione

Dopo l'approvazione di Marketplace, la scheda del componente aggiuntivo è disponibile in tutti i domini Google Workspace for Education nelle regioni selezionate. Deseleziona l'opzione Non in elenco nella configurazione dell'app dell'SDK Marketplace per visualizzare la scheda del componente aggiuntivo nei risultati di ricerca e durante la navigazione.