Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa guida descrive la procedura di revisione per i componenti aggiuntivi di Classroom.
Leggi attentamente, in quanto ci sono azioni urgenti che devi
eseguire.
Il componente aggiuntivo deve essere verificato tramite OAuth dal team Trust &
Safety e approvato dal team 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,
vedi Informazioni sulla revisione delle app.
Finalizzare lo sviluppo del componente aggiuntivo
Esaminare i requisiti dei componenti aggiuntivi
Verifica che il comportamento del componente aggiuntivo soddisfi i
requisiti.
Testare il componente aggiuntivo
Il tuo componente aggiuntivo viene esaminato in base alle
procedure del nostro
piano di test dei componenti aggiuntivi. Segui le procedure di test
con il tuo componente aggiuntivo pubblico prima di
inviarlo per la pubblicazione. I risultati negativi di questi test possono aumentare
in modo significativo il tempo necessario per l'approvazione
del tuo 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 video
non in elenco. Un video non in elenco può essere raggiunto
solo tramite il suo link. Ti verrà chiesto il link del video all'avvio della
procedura di verifica OAuth. Il team OAuth visualizza il video durante
l'esame della tua applicazione del componente aggiuntivo.
Prepararsi alla pubblicazione
Controlla la configurazione del progetto cloud
Rivedi ciascuna delle seguenti impostazioni di configurazione nel tuo
progetto Google Cloud.
È specificato almeno uno degli ambiti .../auth/userinfo.email o .../auth/userinfo.profilenon sensibili.
Tutti gli altri ambiti richiesti dal tuo
componente aggiuntivo sono specificati. Per i
componenti aggiuntivi di Classroom, devono essere inclusi gli ambiti
sensibili.../auth/classroom.addons.teacher e
.../auth/classroom.addons.student.
Per il campo Video dimostrativo, devi fornire un link
a un video di YouTube che mostri come utilizzi i dati provenienti dagli
ambiti richiesti. Fornisci il link allo screencast registrato in precedenza.
Componente aggiuntivo di Classroom è selezionato in
Integrazione app
L'URI di destinazione del componente aggiuntivo è fornito nell'URI di configurazione allegati.
Vengono 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'email dello sviluppatore nella sezione Link per sviluppatori è un indirizzo email
monitorato regolarmente. Il team di
Marketplace utilizza questo indirizzo per comunicare
con te.
La visibilità dell'app è impostata su Pubblica e la
casella Non in elenco è selezionata.
Consenti ai seguenti account utente del team di revisione del Marketplace
di accedere alla tua applicazione. Aggiungi anche i due utenti insegnanti come
tester delle bozze per l'applicazione del componente aggiuntivo.
teacher@marketplacetest.info
teacher2@marketplacetest.info
student@marketplacetest.info
student2@marketplacetest.info
Riceverai un'email dal team del Marketplace
quando inizierà la revisione. Se i revisori devono eseguire passaggi di configurazione
per utilizzare questi account con il tuo prodotto, rispondi all'email con
istruzioni dettagliate.
Completa la verifica OAuth
Invia per la verifica
Il team Trust & Safety deve verificare che il tuo componente aggiuntivo
utilizzi in modo appropriato gli ambiti OAuth richiesti dalla tua applicazione. Avvia la
verifica dal Centro
di verifica dell'autenticazione del tuo progetto Google Cloud. Fai clic su Prepara per la verifica.
Una finestra di dialogo di conferma elenca i valori configurati nelle pagine Branding dell'autenticazione,
Segmento di pubblico e Accesso ai dati. Verifica che le informazioni siano corrette,
poi 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 comunicheranno eventuali dubbi e quando
la verifica sarà completata.
Completare la revisione del Google Workspace Marketplace
Invia per revisione
Fai clic su PUBBLICA nella parte inferiore della pagina
Scheda dello Store 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 app
dell'SDK Google Workspace Marketplace. Ti invieremo una notifica in caso di problemi con il tuo
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 del Marketplace, la scheda del componente aggiuntivo è disponibile in tutti i domini Google Workspace for Education nelle regioni che hai selezionato. Deseleziona l'opzione Non in elenco nella
Configurazione app dell'SDK di Marketplace per visualizzare
la scheda del componente aggiuntivo nei risultati di ricerca e durante
la navigazione.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[],[],null,["# Review process\n\nThis guide describes the review process for Classroom add-ons.\nRead through carefully, as there are time-sensitive actions that you must\nperform.\n| **Key Point:** Thoroughly review the items in this guide *before publishing your\n| add-on*.\n\nYour add-on must be OAuth verified by the Trust \\&\nSafety team and approved by the Google Workspace Marketplace team. For general\ninformation about OAuth verification, see the [OAuth verification FAQ](//support.google.com/cloud/answer/9110914#zippy=%2Csteps-for-apps-requesting-sensitive-scopes%2Csteps-to-prepare-for-verification). For\ngeneral information about the Google Workspace Marketplace app review process\nsee [About app review](/workspace/marketplace/about-app-review).\n\nFinalize add-on development\n---------------------------\n\n\u003cbr /\u003e\n\n#### Review add-on requirements\n\nConfirm that your add-on behavior meets the\n[requirements](/workspace/classroom/add-ons/requirements).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Test your add-on\n\nYour add-on is reviewed according to the\nprocedures in our\n[add-ons test plan](/static/workspace/classroom/assets/classroom_add_ons_test_plan.pdf). Follow its testing\nprocedures with your public add-on before\nsubmitting for publication. Failures in these tests can significantly\nincrease the time required for your add-on to be\napproved.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| **Key Point:** The add-ons test plan contains the same tests used by the Google Workspace Marketplace review team. You should proactively test that your add-on produces expected behaviors in all applicable tests.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Record a demo video\n\nCreate a screen recording demonstrating how your application uses each\nrequested OAuth scope. For the purposes of developing an\nadd-on, we recommend showing the\nadd-on installation flow and creation of an\nadd-on attachment.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nOnce recorded, upload the screen recording to YouTube as an\n*unlisted* video to YouTube. An unlisted video can only be reached\nusing its link. You'll be prompted for the video link when starting the\nOAuth verification process. The OAuth team then views the video when\nreviewing your add-on application.\n\n\u003cbr /\u003e\n\nPrepare for publication\n-----------------------\n\n\u003cbr /\u003e\n\n#### Check your Cloud project configuration\n\nReview each of the following configuration settings in your\n**Google Cloud project**.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| **Caution:** When checking these configuration settings, make sure the correct Cloud project is selected at the top of the Google Cloud console.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n- In your Cloud project's [Auth Audience](//console.cloud.google.com/auth/audience) page:\n - Publishing status is **In production**.\n - User type is **External**.\n- In your Cloud project's [Auth Branding](//console.cloud.google.com/auth/branding) page:\n - All required fields are complete.\n - Ensure that your application home page doesn't link to the app itself, but rather to information about your product(s).\n- In your Cloud project's [Auth Data Access](//console.cloud.google.com/auth/scopes) page:\n - At least one of the `.../auth/userinfo.email` or `.../auth/userinfo.profile` **non-sensitive** scopes are specified.\n - *All other scopes* required by your add-on are specified. For Classroom add-ons, this should include the **sensitive** `.../auth/classroom.addons.teacher` and `.../auth/classroom.addons.student` scopes.\n - For the **Demo video** field, you must provide a link to a YouTube video that demonstrates how you use the data from the requested scopes. Provide the link to the screencast recorded earlier.\n- The following [API libraries](//console.cloud.google.com/apis/library) are **Enabled** :\n - [Google Classroom API](//console.cloud.google.com/apis/library/classroom.googleapis.com)\n - [Google Workspace Marketplace SDK](//console.cloud.google.com/apis/library/appsmarket-component.googleapis.com)\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Check your Marketplace SDK\nsettings\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| **Caution:** When checking these configuration settings, make sure the correct Cloud project is selected at the top of the Google Cloud console page.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nIn your\n[Google Workspace Marketplace SDK App Configuration](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk) page:\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n- **Classroom add-on** is checked under App Integration\n- The landing URI for your add-on is provided in the **Attachment Setup URI**.\n- All **Allowed Attachment URI Prefixes** are provided.\n- The list of **OAuth Scopes** exactly matches the scopes specified in the OAuth consent screen and in your application code.\n- The **Developer Email** under Developer Links is a *regularly monitored* email address. The Marketplace team uses this address to communicate with you.\n- App Visibility is set to **Public** and the **Unlisted** box is checked.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nCheck that your project's\n[Google Workspace Marketplace Store Listing](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk_publish) page complies with the\n[Listing considerations](/workspace/classroom/add-ons/developer-guides/project-configuration#workspace_marketplace_name-listing).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Allow reviewer access\n\nAllow the following Marketplace review team user\naccounts access to your application. Also add the two teacher users as\n[Draft Testers](/workspace/marketplace/manage-app-listing#draft-app-listing) for your add-on application.\n\n- `teacher@marketplacetest.info`\n- `teacher2@marketplacetest.info`\n- `student@marketplacetest.info`\n- `student2@marketplacetest.info`\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nYou'll receive an email from the Marketplace\nteam when they begin their review. If the reviewers must perform any setup\nsteps to use these accounts with your product, reply to the email with\ndetailed instructions.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| **Important:** Reviewers may connect to your application from Argentina, Canada, and the United States. Ensure these regions are not blocked in your implementation and allowed under **Distribution** in the Marketplace SDK [Store Listing](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk_publish) page. You can change the Distribution configuration after your add-on is approved.\n\n\u003cbr /\u003e\n\nComplete OAuth verification\n---------------------------\n\n\u003cbr /\u003e\n\n#### Submit for verification\n\nThe Trust \\& Safety team must check that your add-on\nappropriately uses the OAuth scopes that your application requests. Initiate\nverification from your Google Cloud project's\n[Auth Verification\nCenter](//console.cloud.google.com/auth/verification). Click **Prepare for verification**.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nA confirmation dialog lists the configured values from the Auth Branding,\nAudience, and Data Access pages. Verify that the information is correct,\nthen click **Confirm** to proceed.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Communicate with the verification team\n\nThe OAuth verification team processes your verification request. The\nreviewers communicate with you using the email addresses configured in your\nOAuth Consent screen. They will inform you of any concerns and when\nverification is complete.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThis process typically requires 3-5 working days if you are only using\n[Sensitive OAuth scopes](/identity/protocols/oauth2/production-readiness/sensitive-scope-verification). Additional time and actions may be required if\nyou are using any\n[Restricted OAuth scopes](/identity/protocols/oauth2/production-readiness/restricted-scope-verification).\n\n\u003cbr /\u003e\n\nComplete Google Workspace Marketplace review\n--------------------------------------------\n\n\u003cbr /\u003e\n\n#### Submit for review\n\n| **Tip:** You can apply for Marketplace review and OAuth verification simultaneously. However, your application must complete OAuth verification before it can receive final Marketplace approval.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nClick **PUBLISH** at the bottom of your Google Cloud project's\n[Google Workspace Marketplace Store Listing](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk_publish) page. The\nMarketplace review team tests the\nadd-on against Google Workspace and\nClassroom add-on requirements.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Communicate with the review team\n\nThe Marketplace review team communicates directly\nwith the Developer Email address specified in the\nGoogle Workspace Marketplace SDK\n[App Configuration](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk) page. You are notified about any concerns with your\nadd-on, or to inform you that it has been approved\nfor publication. We recommend budgeting 2-3 weeks for this process.\n\n\u003cbr /\u003e\n\nAfter publication approval\n--------------------------\n\nAfter Marketplace approval, your\nadd-on listing is available in all Google Workspace for Education\ndomains in the regions you selected. Unselect the **Unlisted** option in the\nMarketplace SDK [App Configuration](//console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk) to make your\nadd-on listing appear in search results and when\nbrowsing."]]
