Procedura di revisione delle app e requisiti per Google Workspace Marketplace

Per pubblicare un'app pubblicamente in Google Workspace Marketplace, Google esamina la tua app e la relativa scheda per verificare che rispettino le linee guida relative a progettazione, contenuti e stile di Google.

Dopo che Google avrà esaminato la tua app, riceverai un'email che ti informa se necessita di ulteriore lavoro o se è stata approvata.

• Se la tua app richiede lavoro aggiuntivo: riceverai un documento di revisione con informazioni specifiche sugli aspetti da migliorare. Risolvi i problemi e invia di nuovo la tua app per la revisione.
• Se il team di revisione approva la tua app: l'app viene pubblicata automaticamente e ricevi un'email di notifica.

Prima di inviare la tua app per la revisione, assicurati che sia pronta per la pubblicazione. Per maggiori dettagli, consulta la sezione Prepararsi per il processo di pubblicazione.

Durata della revisione

La revisione dell'app richiede in genere diversi giorni. Il tempo necessario dipende da:

• Quante app sono state inviate di recente
• Il lavoro aggiuntivo richiesto dalla tua app

Motivi comuni per cui un'app non supera la revisione

Verifica OAuth:

• Configurazione errata della schermata per il consenso OAuth. Ad esempio, il tipo di utente è impostato su Interno o lo stato di pubblicazione è impostato su Test.
• L'app non ha completato la verifica OAuth.

Problemi relativi alla scheda dell'app:

• Uso inappropriato dei marchi di Google nel nome, nel logo o nelle descrizioni dell'app. Per indicazioni, consulta le linee guida per il branding di Google Workspace Marketplace.
• I link non funzionano o rimandano a informazioni errate. Ad esempio, un link relativo alle norme sulla privacy rimanda a una pagina di assistenza per gli sviluppatori.
• Gli screenshot e le immagini sono di bassa qualità o non rappresentano in modo accurato la funzionalità dell'app.

Preparazione dell'app:

• L'app è ancora in fase di test e non è pronta per il pubblico.
• L'app presenta bug o non è completamente funzionante.

Criteri di revisione

Prima di inviare la tua app per la revisione, assicurati che soddisfi tutti i requisiti e sia conforme alle norme del programma di Google Workspace Marketplace.

• Requisiti per tutte le app
• Requisiti per integrazioni di app specifiche

Requisiti per tutte le app

Puoi utilizzare le caselle di controllo per monitorare la revisione preliminare. Deselezionare le caselle di controllo

Categoria	Criteri
Nome dell'app	Non sono presenti altre schede di app con lo stesso nome. Il nome non include un numero di versione. Il nome corrisponde a quello indicato nella schermata per il consenso OAuth. Il nome non è vago o troppo generico. Il nome non può superare i 50 caratteri. (Consigliato) Il nome utilizza le iniziali maiuscole. (Consigliato) Il nome non contiene punteggiatura, in particolare parentesi.
Informazioni sugli sviluppatori	Il nome e il sito web dello sviluppatore rappresentano in modo accurato le informazioni pertinenti e lo indirizzano a informazioni pertinenti. Ai sensi delle leggi per la tutela dei consumatori, i consumatori che risiedono nello Spazio economico europeo (SEE) devono essere informati se un commerciante su Google Workspace Marketplace è un commerciante o un non commerciante: Commerciante: un commerciante è una persona che agisce per scopi relativi a un'attività commerciale, un'attività, un mestiere o una professione; oppure in nome o per conto di un commerciante. Non commerciante: un non commerciante (consumatore) è una persona che agisce per scopi non professionali. Se questo valore non viene specificato, nella pagina della scheda dello Store della tua app viene visualizzato lo stato "Stato commerciante non specificato".
Descrizione app	Tutti i link forniti funzionano e rimandano alle informazioni corrette. Ad esempio, un link relativo alle norme sulla privacy rimanda a una pagina che le descrive. Se l'app interagisce con un servizio di terze parti, la descrizione descrive che cosa fa quest'ultimo, il modo in cui l'app interagisce con il servizio e, facoltativamente, rimanda al sito web pertinente. Le descrizioni brevi e dettagliate sono comprensibili. Le descrizioni brevi e dettagliate non sono identiche. (Consigliato) Le informazioni sui prezzi sono complete e accurate. (Consigliato) Il set completo di attributi per lingua (nome, descrizione breve e descrizione dettagliata) è definito correttamente senza mancata corrispondenza della lingua.
Funzionalità	Non esistono bug evidenti e tutte le azioni, inclusi i casi limite, sono completamente funzionali. I tempi di caricamento sono gestiti con indicatori di caricamento. L'app dimostra interazioni chiare con le API di Google. L'app fornisce una funzionalità nuova o estesa che non equivale a quanto già incluso nei prodotti Google. L'app non è concepita per scopi pubblicitari o di spam. L'app è completamente funzionale e non è destinata a scopo di test, non è ancora in fase di sviluppo. Se l'app interagisce con funzionalità disponibili per gli utenti o gli utenti paganti, viene fornito un account di prova sul sistema dello sviluppatore al team di revisori di Google.
Esperienza utente	L'app, incluso il nome, non utilizza gli asset del brand, i marchi di Google o i contenuti con brand Google. Consulta le linee guida per il branding di Google Workspace Marketplace. L'autorizzazione e l'accesso sono richiesti una sola volta. L'app utilizza l'accesso SSO con un solo clic o, idealmente, il servizio SSO zero-click. Dopo che un amministratore ha concesso le autorizzazioni per gli ambiti OAuth 2.0 per il dominio, ai singoli utenti non vengono più richieste le autorizzazioni per l'ambito. Gli utenti non devono inserire le credenziali dopo aver eseguito l'accesso al proprio Account Google. Al massimo, devono fare clic su un pulsante "Accedi con Google" per ottenere l'accesso. Per le etichette dei pulsanti, le voci di menu, i titoli e altri elementi dell'app esistono termini coerenti, ovvi e comprensibili. Ad esempio, invece di Sì o No, le etichette fanno riferimento a nomi di azioni come Elimina e Annulla. Se è necessario eseguire l'accesso, la funzionalità di uscita funziona correttamente. I token vengono revocati e l'accesso può iniziare dall'inizio. Il feedback viene sempre visualizzato, ad esempio i messaggi di conferma o di errore, per le azioni. Non sono presenti link immagine inaccessibili o immagini sfocate.
Elementi grafici	Le icone hanno le dimensioni corrette, quadrate e hanno uno sfondo trasparente. Vedi Risorse grafiche. L'icona rappresenta correttamente il nome o la funzionalità dell'app. L'icona è a colori (non in scala di grigio). L'icona non utilizza marchi di Google. Gli screenshot e le immagini non sono sfocate, difficili da leggere o inappropriate. Rappresentano l'app in modo accurato. (Consigliato) Gli screenshot mostrano chiaramente come utilizzare l'app e la sua funzione.
OAuth	L'app ha superato la verifica OAuth, utilizza gli ambiti OAuth più ristretti possibili e tutti gli ambiti si integrano correttamente con le API dei servizi Google.

Requisiti aggiuntivi per integrazioni di app specifiche

Seleziona le integrazioni di app incluse nella scheda dell'app per visualizzare i criteri di revisione pertinenti. Puoi fare clic sui nomi delle colonne per ordinare i criteri, ad esempio per categoria.

Puoi utilizzare le caselle di controllo per monitorare la revisione preliminare. Deselezionare le caselle di controllo

Componente aggiuntivo di Google Workspace Componente aggiuntivo dell'editor App web App Drive App Google Chat

Integrazione app	Categoria	Criteri
App Google Chat	Nome	I pulsanti per comunicare con l'app sono disponibili nella descrizione. Il nome dell'app inizia con la A-Z (maiuscole) o con 0-9. Non può iniziare con un simbolo.
App Google Chat	Esperienza utente	L'app invia un messaggio di benvenuto non richiesto ogni volta che un utente avvia un messaggio diretto o l'app viene aggiunta a uno spazio. Il messaggio di benvenuto è diverso dal comando "Help". Per ulteriori informazioni, consulta Inviare un messaggio della scheda della home page dell'app. L'app supporta il comando "Help" e aiuta gli utenti a iniziare a utilizzarla. Per maggiori informazioni, consulta la sezione Rispondere ai comandi slash. L'app risponde sempre quando parla in uno spazio o in Chat diretta. I messaggi utilizzano l'ortografia, le lettere maiuscole e la punteggiatura in modo corretto e non contengono materiali dannosi, offensivi o illeciti. I messaggi utilizzano una formattazione chiara, concisa e coerente per il testo o le schede, in base ai requisiti di Google. Se una risposta richiede più di 2 secondi, l'app invia un messaggio per spiegare il ritardo. Le app che inviano notifiche consentono agli utenti di disattivarle. Gli utenti possono aggiungere l'app a uno spazio usando la @menzione. Gli utenti possono rimuovere l'app da uno spazio utilizzando il menu Visualizza membro. L'app indica all'utente tutto ciò che è necessario per interagirvi. Il formato delle schede utilizzato dall'app soddisfa i requisiti di Google. Consulta la pagina Creare schede interattive. L'app è disponibile dall'opzione Trova app nel menu Chat. Gli URL esterni con cui interagisce l'app non appartengono a un ambiente di gestione temporanea o di sviluppo. La @menzione è obbligatoria in ogni messaggio inviato all'app negli spazi. Solo così l'app sa che deve rispondere. Se l'app di chat mostra l'anteprima dei link di un dominio di terze parti: Le anteprime dei link offrono informazioni supplementari pertinenti al messaggio dell'utente. Ad esempio, l'anteprima di un link a un accordo di vendita aggiunge informazioni come account, importo e fase. Lo sviluppatore è affiliato al dominio in anteprima. Per saperne di più, consulta la sezione Link alle anteprime. (Opzione consigliata) Per consentire agli amministratori di Workspace di installare la tua app per conto degli utenti della loro organizzazione, l'app deve essere in grado di ricevere e inviare messaggi diretti.
App Google Chat	Elementi grafici	L'app ha un avatar riconoscibile e chiaro.
App Google Drive	Funzionalità	L'app non utilizza le estensioni del browser Chrome per fornire la funzionalità manipolando direttamente il codice HTML di Drive. Se la tua app utilizza ambiti sensibili o con restrizioni, deve essere sottoposta a verifica OAuth. Consulta Come posso richiedere la verifica. Se la tua app utilizza ambiti con restrizioni, deve anche essere sottoposta a una valutazione della sicurezza. Vedi Perché è necessaria la valutazione della sicurezza.
App Google Drive	Esperienza utente	Se l'app archivia i file su Drive, gli utenti possono scegliere una cartella oppure viene creata e riutilizzata una cartella specifica dell'app. I dati di configurazione possono essere archiviati in una cartella Dati app. L'app non esegue il dump dei file nella cartella Il mio Drive dell'utente. L'app archivia in Drive solo i file collegati alla funzionalità documentata dell'app.
Componente aggiuntivo dell'editor	Funzionalità	Le azioni previste e richieste sono incluse nel componente aggiuntivo, che fornisce tutti gli strumenti necessari per completare il flusso di lavoro. Ecco alcuni esempi: Se il componente aggiuntivo applica gli stili all'intero documento, offre la possibilità di applicare gli stili solo al testo selezionato. Se il componente aggiuntivo carica i dati del foglio di lavoro in un feed di servizi web, avrà un link al feed per semplificare la navigazione. Se il componente aggiuntivo richiede all'utente di avere un account, fornisce link o informazioni per creare facilmente un account, qualora l'utente non ne abbia già uno. Il componente aggiuntivo contiene voci di menu nella scheda Componenti aggiuntivi. Anche se il componente aggiuntivo è solo funzioni personalizzate, include comunque la documentazione adeguata. Il componente aggiuntivo utilizza correttamente onInstall() e onOpen() per completare il menu. Le voci di menu vengono compilate alla prima installazione del componente aggiuntivo e quando viene aperto un altro file. Vedi Autorizzazione dei componenti aggiuntivi dell'editor. Le modalità di autorizzazione sono impostate correttamente. Vedi Modalità di autorizzazione.
Componente aggiuntivo dell'editor	Esperienza utente	Il componente aggiuntivo fornisce tutte le informazioni necessarie per acquisire una conoscenza di base del prodotto e del suo utilizzo. Il codice del componente aggiuntivo non utilizza troppe librerie, in quanto le librerie possono causare una perdita di prestazioni del componente aggiuntivo. Se possibile, gli errori vengono evitati e gestiti correttamente. In caso contrario: I messaggi di errore vengono visualizzati in una finestra di dialogo, non in un avviso JavaScript o sulla barra rossa predefinita. Comunicano il problema e descrivono cosa deve fare l'utente per risolverlo in un linguaggio semplice. Quando possibile, se l'utente sta svolgendo un'azione errata, viene visualizzato un pulsante che consente di risolvere il problema. Per ulteriori informazioni, consulta la guida di stile per i componenti aggiuntivi. I link a pagine esterne si aprono in nuove finestre e sono corretti. Il componente aggiuntivo è intuitivo e ben progettato. Ciò significa che: È sempre chiaro cosa fare e come farlo. Il componente aggiuntivo è accessibile e semplice da capire. Sono da evitare termini tecnici e gergali. I flussi di lavoro sono il più possibile chiari e semplificati. L'utente e i suoi contenuti sono il più sicuri possibile. Il componente aggiuntivo segue la guida di stile dell'interfaccia utente per i componenti aggiuntivi dell'editor e utilizza il pacchetto CSS per i componenti aggiuntivi dell'editor. Il componente aggiuntivo utilizza una sola azione principale blu per display. Il componente aggiuntivo mostra una finestra di dialogo alla volta. Non si sovrappone a un elemento e non contiene più finestre di dialogo aperte alla volta. L'UI del componente aggiuntivo si adatta perfettamente agli spazi assegnati: Il testo e le etichette non vengono troncati con "..." L'utente non deve scorrere molto in verticale. La larghezza dei contenuti non si estende oltre i 300p e non dispone di una barra di scorrimento orizzontale. Il componente aggiuntivo richiede una conferma o mostra avvisi per tutte le azioni sensibili. Ad esempio, se il componente aggiuntivo sta per sovrascrivere tutti i contenuti di un foglio di lavoro, l'utente riceve un avviso e conferma l'azione prima che si verifichi. Puoi evitare questo requisito apportando modifiche al design. Ad esempio, un componente aggiuntivo di Fogli Google che importa i dati crea il rischio di sovrascrivere i contenuti esistenti. Puoi rimuovere il rischio creando un foglio per i dati come azione predefinita. Gli utenti non possono attivare più volte le azioni durante il caricamento di un'azione. Ad esempio, i pulsanti sono disattivati o nascosti durante il caricamento di un'azione.
Componente aggiuntivo di Google Workspace	Nome	Componenti aggiuntivi di Calendar Se il componente aggiuntivo utilizza calendar.name o common.name, il nome nel file manifest è identico a quello fornito nella scheda dell'app. Se il componente aggiuntivo utilizza calendar.conferenceSolution, il nome della soluzione per conferenze non contiene "Google Calendar". (Consigliato) Se il componente aggiuntivo utilizza calendar.conferenceSolution, il nome della soluzione di conferenza non deve superare i 30 caratteri.
Componente aggiuntivo di Google Workspace	Funzionalità	Il componente aggiuntivo utilizza i widget corretti per la funzionalità desiderata. Ad esempio, utilizza un sensore per selezionare un valore booleano. Componenti aggiuntivi di Calendar I calendari secondari e le deleghe sono supportati o, se non sono supportati, vengono gestiti agevolmente. Ad esempio, la creazione di una conferenza non avrà esito negativo se l'utente seleziona un calendario diverso a cui ha accesso in modifica durante la creazione di un evento. Gli eventi ricorrenti funzionano correttamente. Se il componente aggiuntivo utilizza calendar.conferenceSolution, viene fornita almeno una soluzione di conferenza. Se il componente aggiuntivo offre soluzioni di conferenza, vengono utilizzati i campi dei dati di conferenza appropriati. Ad esempio, i link per videoconferenze, i numeri di telefono, i link SIP, i codici di accesso e altri attributi supportati utilizzano campi di dati strutturati e non vengono forniti nel campo delle note. Se il componente aggiuntivo fornisce soluzioni di conferenza, modifica solo i dettagli della conferenza e nessun altro campo evento. Se il componente aggiuntivo fornisce soluzioni di conferenza, la creazione della conferenza richiede meno di 5 secondi. Componenti aggiuntivi di Gmail Se il componente aggiuntivo utilizza UrlFetchApp o OpenLinkUrl: L'URL è valido. L'URL utilizza HTTPS, non HTTP. È specificato il dominio completo. Il percorso non è vuoto. Ad esempio, https://altostrat/ è accettabile, mentre https://altostrat non lo è. I caratteri jolly non possono essere utilizzati in UrlFetchApp.
Componente aggiuntivo di Google Workspace	Esperienza utente	Il componente aggiuntivo ha una home page. Se il componente aggiuntivo di Google Workspace è un componente aggiuntivo di Gmail convertito, viene applicata una home page predefinita. La scheda dei componenti aggiuntivi funziona correttamente. Ad esempio, non ci sono schede duplicate; i pulsanti Indietro, Aggiorna e Aggiorna funzionano di conseguenza. Dopo l'autorizzazione del componente aggiuntivo, l'utente visualizza una scheda della home page personalizzata con un pulsante per l'accesso (se necessario), un logo e una breve descrizione del componente aggiuntivo. Se il pulsante di accesso viene attivato, viene visualizzata una pagina di accesso personalizzata del fornitore di terze parti che indica chiaramente che è presente un servizio di terze parti che funziona al di fuori di Google Workspace. L'UI del componente aggiuntivo si adatta perfettamente agli spazi assegnati: Il testo e le etichette non vengono troncati con "..." L'utente non deve scorrere molto in verticale. La larghezza dei contenuti non si estende oltre i 300p e non dispone di una barra di scorrimento orizzontale. Il codice del componente aggiuntivo non utilizza troppe librerie, in quanto le librerie possono causare la perdita delle prestazioni del componente aggiuntivo. Componenti aggiuntivi di Calendar Se il componente aggiuntivo fornisce soluzioni di conferenza, le conferenze create sono valide e visualizzate correttamente sul sito web di conferenza di terze parti. Componenti aggiuntivi di Documenti Se il componente aggiuntivo mostra in anteprima i link di un dominio di terze parti (smart chip): Le anteprime dei link offrono all'utente informazioni supplementari pertinenti e supplementari. Ad esempio, l'anteprima di un link a un accordo di vendita aggiunge informazioni come account, importo e fase. Lo sviluppatore è affiliato al dominio in anteprima. Per maggiori informazioni, consulta Visualizzare l'anteprima dei link con smart chip. Componenti aggiuntivi per Drive Se l'app archivia i file su Drive, gli utenti possono scegliere una cartella oppure viene creata e riutilizzata una cartella specifica dell'app. I dati di configurazione possono essere archiviati in una cartella Dati app. L'app non esegue il dump dei file nella cartella Il mio Drive dell'utente. Il componente aggiuntivo archivia in Drive solo i file collegati alla funzionalità documentata del componente aggiuntivo. Componenti aggiuntivi di Gmail Il componente aggiuntivo non menziona o non rimanda alle estensioni del browser Chrome senza giustificazione. Il menu Altre azioni contiene azioni universali che funzionano correttamente. ad esempio Esci, Informazioni, Assistenza e così via.
Componente aggiuntivo di Google Workspace	Elementi grafici	Componenti aggiuntivi di Calendar Il logo della soluzione di conferenza è un URL pubblico. Consulta la pagina Fornisci i loghi delle soluzioni per conferenze. Se il componente aggiuntivo utilizza calendar.conferenceSolution, il logo della soluzione di conferenza soddisfa i requisiti di calendar.logoUrl. Vedi la risorsa manifest di Calendar. Se il componente aggiuntivo utilizza calendar.logoUrl o common.logoUrl, il logo è identico all'icona fornita nella scheda dell'app. Se il componente aggiuntivo utilizza calendar.logoUrl o common.logoUrl, l'URL del logo inizia come segue: https://lh3.googleusercontent.com/
Componente aggiuntivo di Google Workspace	OAuth	Componenti aggiuntivi per Drive (Consigliato) Se vuoi ricevere metadati limitati, il componente aggiuntivo include l'ambito drive.addons.metadata.readonly.
App web	Funzionalità	L'URL di navigazione universale rimanda a un'app web. Una pagina web semplice senza funzionalità non viene considerata un'app web.