Procedura di revisione delle app e requisiti per Google Workspace Marketplace
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Per pubblicare un'app pubblicamente su Google Workspace Marketplace, Google esamina
l'app e la relativa scheda per assicurarsi che soddisfino le linee guida di Google relative a design, contenuti e
stile.
Dopo che Google avrà esaminato la tua app, riceverai un'email che ti comunicherà se sono necessari ulteriori
interventi o se l'app è stata approvata.
Se la tua app richiede un lavoro aggiuntivo: riceverai un documento di revisione con
informazioni specifiche su cosa deve essere migliorato. Risolvi i problemi e
invia di nuovo l'app per la revisione.
Se il team di revisione approva la tua app: viene pubblicata automaticamente e ricevi un'email di notifica.
La revisione dell'app in genere richiede diversi giorni. Il tempo necessario dipende da:
Quante app sono state inviate di recente
Quanto lavoro aggiuntivo richiede la 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.
I link non funzionano o rimandano a informazioni errate. Ad esempio, un link
per le norme sulla privacy indirizza a una pagina di assistenza per gli sviluppatori.
Gli screenshot e le immagini sono di bassa qualità o non rappresentano in modo accurato le funzionalità dell'app.
Idoneità dell'app:
L'app è ancora in fase di test e non è pronta per la pubblicazione.
L'app presenta bug o non è completamente funzionante.
Puoi utilizzare le caselle di controllo per monitorare la revisione preliminare.
Categoria
Criteri
Nome dell'app
Non esistono altre schede dell'app con lo stesso nome.
Il nome non include un numero di versione.
Il nome corrisponde a quello della schermata per il consenso OAuth.
Il nome non sia vago o troppo generico.
Il nome contiene al massimo 50 caratteri.
(Consigliato) Il nome utilizza la maiuscola iniziale.
(consigliato) Il nome non contiene punteggiatura,
in particolare parentesi.
(Consigliato) Il nome corrisponde a quello visualizzato nelle applicazioni Google Workspace. Ad esempio, nei componenti aggiuntivi Google Workspace, il nome nel manifest è simile a quello fornito nella scheda dell'app.
Informazioni per gli sviluppatori
Il nome e il sito web dello sviluppatore rappresentano con precisione e
indirizzano a informazioni pertinenti sullo sviluppatore.
Ai sensi delle leggi per la tutela dei consumatori, i consumatori che risiedono nello
Spazio economico europeo (SEE) devono essere informati se un venditore
sul Google Workspace Marketplace è un commerciante o un
non commerciante:
Commerciante: una persona che agisce per scopi relativi
a un'attività commerciale, imprenditoriale, artigianale o professionale; o a nome o per conto
di un commerciante.
Non commerciante: un non commerciante (consumatore) è una persona che agisce per
scopi non professionali.
Se non specificato, nella pagina della
scheda dello Store
della tua app viene visualizzato "Stato commerciante non specificato".
Descrizione app
Tutti i link forniti funzionano e rimandano alle informazioni corrette.
Ad esempio, un link alle norme sulla privacy indirizza a una pagina
che descrive le norme sulla privacy.
Se l'app interagisce con un servizio di terze parti, la descrizione
descrive cosa fa il servizio di terze parti, come interagisce l'app
con esso e, facoltativamente, include un link al sito web pertinente.
Le descrizioni brevi e dettagliate sono comprensibili.
Le descrizioni breve e dettagliata non sono identiche.
(Consigliato) Le informazioni sui prezzi sono complete e
accurate.
(Consigliato) L'insieme completo di attributi per lingua
(nome, descrizione breve e descrizione dettagliata) è definito
correttamente senza mancata corrispondenza della lingua.
Funzionalità
Non sono presenti bug evidenti e tutte le azioni, inclusi i casi limite,
sono completamente funzionali. I tempi di caricamento vengono gestiti con indicatori di caricamento.
L'app mostra interazioni chiare con le API di Google.
L'app fornisce una funzionalità nuova o estesa che non è
equivalente a quella già inclusa nei prodotti Google.
L'app non è pensata per scopi pubblicitari o di spam.
L'app è completamente funzionale e non è destinata a scopi di test, non è un lavoro in corso.
Se l'app interagisce con funzionalità disponibili per gli utenti
o per gli utenti a pagamento, viene fornito un account di test sul sistema dello sviluppatore
per il team di revisione di Google.
L'autorizzazione e l'accesso sono richiesti una sola volta. L'app utilizza
l'SSO con un solo clic o, idealmente, l'SSO con zero clic.
Dopo che un amministratore concede le autorizzazioni per gli ambiti OAuth 2.0 per il dominio, ai singoli utenti non vengono più richieste le autorizzazioni per gli ambiti.
Gli utenti non devono inserire le credenziali dopo aver eseguito l'accesso al proprio Account Google. Al massimo, devono fare clic sul pulsante "Accedi con
Google" per ottenere l'accesso.
Esistono termini coerenti, ovvi e comprensibili per
etichette dei pulsanti, voci di menu, titoli e altri elementi dell'app. Ad esempio, anziché
Sì o No, le etichette si riferiscono a nomi di azioni come Elimina e Annulla.
Se è richiesto l'accesso, la funzionalità di disconnessione funziona correttamente.
I token vengono revocati e l'accesso può iniziare dall'inizio.
Il feedback viene sempre visualizzato, ad esempio messaggi di conferma o
di errore, per le azioni.
Non ci sono link immagine non funzionanti o immagini sfocate.
Elementi grafici
Le icone hanno dimensioni corrette, sono quadrate e hanno sfondi
trasparenti. Vedi Risorse
grafiche.
L'icona rappresenta correttamente il nome o la funzionalità dell'app.
L'icona sia a colori (non in scala di grigi).
L'icona non utilizza i marchi di Google.
Gli screenshot e le immagini non sono sfocati, difficili da leggere o
inappropriati. Rappresentano in modo accurato l'app.
(Consigliato) Gli screenshot mostrano chiaramente come utilizzare l'app
e cosa fa.
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.
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 una lettera maiuscola (A-Z) o un numero (0-9). Non può iniziare
con un simbolo.
App Google Chat
Funzionalità
L'app Chat dispone di funzionalità interattive e può essere aggiunta a messaggi diretti o spazi.
App Google Chat
Esperienza utente
L'app invia un messaggio di benvenuto non richiesto ogni volta che un utente
inizia un messaggio diretto o l'app viene aggiunta a uno spazio. Il
messaggio di benvenuto è diverso dal comando "Aiuto". Visualizza la documentazione.
L'app è disponibile dall'opzione Trova app
nel menu Chat.
Gli URL esterni con cui l'app interagisce non appartengono a un
ambiente di staging o di sviluppo.
La @menzione è obbligatoria in ogni messaggio all'app negli spazi.
È l'unico modo in cui l'app sa che deve rispondere.
Se l'app Chat visualizza l'anteprima dei link di un dominio di terze parti:
Le anteprime dei link offrono informazioni pertinenti e aggiuntive al
messaggio dell'utente. Ad esempio, l'anteprima di un link a un'offerta di vendita aggiunge
informazioni come account, importo e fase.
Lo sviluppatore è affiliato al dominio visualizzato in anteprima.
(Consigliato) Per consentire agli amministratori di Workspace di installare la tua app
per conto degli utenti della loro organizzazione, la tua 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 funzionalità manipolando direttamente l'HTML di Drive.
Se la tua app utilizza ambiti sensibili o con restrizioni, deve essere sottoposta a
verifica OAuth. Consulta Invio dell'app per la verifica.
Se la tua app utilizza ambiti con restrizioni, deve anche superare una
valutazione della sicurezza. Vedi Valutazione della sicurezza.
App Google Drive
Esperienza utente
Se l'app archivia i file in Drive, consente agli utenti
di scegliere una cartella
o crea e riutilizza una cartella specifica dell'app. I dati di configurazione possono
essere archiviati in una cartella Dati app. L'app non scarica i file nella
cartella Il mio Drive dell'utente.
L'app memorizza i file solo in Drive collegato alla
funzionalità documentata dell'app.
Componente aggiuntivo Editor
Funzionalità
Le azioni previste e richieste sono incluse nel componente aggiuntivo, che
fornisce tutti gli strumenti necessari per completare il flusso di lavoro. Ad esempio:
Se il componente aggiuntivo applica lo stile all'intero documento, offre
la possibilità di applicare lo stile solo al testo selezionato.
Se il componente aggiuntivo carica i dati del foglio di lavoro in un feed di servizi web,
ha un link a quel feed per facilitare la navigazione.
Se il componente aggiuntivo richiede all'utente di disporre di un account, fornisce link o informazioni per creare facilmente un account se l'utente non ne ha già uno.
Il componente aggiuntivo ha voci di menu nella scheda Componenti aggiuntivi.
Anche se il componente aggiuntivo include solo funzioni personalizzate, deve comunque includere
una documentazione adeguata.
Il componente aggiuntivo utilizza correttamente onInstall() e
onOpen() per compilare il menu. Le voci di menu vengono compilate
quando il componente aggiuntivo viene installato per la prima volta e quando viene aperto un file diverso. Vedi
Autorizzazione del componente aggiuntivo Editor.
Il componente aggiuntivo deve essere implementato nel runtime V8 di Apps Script. Per saperne di più, consulta la panoramica del runtime V8.
Componente aggiuntivo Editor
Esperienza utente
Il componente aggiuntivo fornisce tutte le informazioni necessarie per avere una conoscenza di base del prodotto e di come utilizzarlo.
Il codice del componente aggiuntivo non utilizza librerie in modo eccessivo, in quanto
le librerie possono causare un calo delle prestazioni del componente aggiuntivo.
Gli errori vengono evitati, se possibile, e gestiti correttamente, altrimenti:
I messaggi di errore vengono visualizzati in una finestra di dialogo, non in un
avviso JavaScript o nella 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 facendo qualcosa di sbagliato, viene visualizzato un pulsante che risolve il problema.
Il componente aggiuntivo utilizza una sola azione principale blu per visualizzazione.
Il componente aggiuntivo mostra una finestra di dialogo alla volta. Non si sovrappone o
non ha più finestre di dialogo aperte contemporaneamente.
L'interfaccia utente del componente aggiuntivo si adatta perfettamente agli spazi allocati:
Testo ed etichette non vengono troncati con "..."
L'utente non deve scorrere molto in verticale.
La larghezza dei contenuti non si estende oltre i 300 pixel, in modo da non
avere una barra di scorrimento orizzontale.
Il componente aggiuntivo richiede la 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 viene avvisato
e conferma l'azione prima che venga eseguita.
Puoi evitare questo requisito apportando modifiche alla progettazione.
Ad esempio, un componente aggiuntivo di Fogli Google che importa 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 azioni più volte durante il caricamento di un'azione. Ad esempio, i pulsanti vengono disattivati o nascosti durante il caricamento di un'azione.
Componente aggiuntivo di Google Workspace
Nome
Componenti aggiuntivi per Calendar
Se il componente aggiuntivo utilizza calendar.name o
common.name, il nome nel manifest è identico
al nome fornito nella scheda dell'app.
Se il componente aggiuntivo utilizza calendar.conferenceSolution, il
nome della soluzione di conferenza non contiene "Google Calendar".
(consigliato) Se il componente aggiuntivo utilizza
calendar.conferenceSolution, il nome della soluzione di conferenza
non supera i 30 caratteri.
Componente aggiuntivo di Google Workspace
Funzionalità
Il componente aggiuntivo utilizza l'elemento UI corretto (ad esempio
widget o UI in iframe nei componenti aggiuntivi Meet) per la funzionalità desiderata. Ad esempio, utilizza un
interruttore per selezionare un valore booleano.
Componenti aggiuntivi per Calendar
I calendari secondari e la delega sono supportati o, in caso contrario, gestiti in modo controllato. Ad esempio, la creazione di una conferenza
non ha esito negativo se l'utente
seleziona un altro calendario a cui ha accesso in modifica quando
crea un evento.
Gli eventi ricorrenti funzionano correttamente.
Se il componente aggiuntivo utilizza calendar.conferenceSolution, viene fornita almeno una soluzione per le conferenze.
Se il componente aggiuntivo fornisce soluzioni di conferenza, vengono utilizzati i campi
dati della conferenza appropriati. Ad esempio, i link per le videoconferenze,
i numeri di telefono, i link SIP, i codici di accesso e altri attributi
supportati utilizzano i campi dei dati strutturati e non vengono forniti nel
campo delle note.
Se il componente aggiuntivo fornisce soluzioni per conferenze, modifica solo
i dettagli della conferenza e nessun altro campo dell'evento.
Se il componente aggiuntivo fornisce soluzioni per conferenze, 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 e non HTTP.
Viene specificato il dominio completo.
Il percorso non è vuoto. Ad esempio,
https://altostrat/ è corretto, ma
https://altostrat non lo è.
Non è possibile utilizzare i caratteri jolly in UrlFetchApp.
Componenti aggiuntivi di Meet
I percorsi di accesso e utente del componente aggiuntivo devono essere funzionali anche se i cookie di terze parti sono disattivati.
Il componente aggiuntivo deve fornire funzionalità pertinenti al funzionamento di una riunione o alla partecipazione a una riunione.
Il componente aggiuntivo non deve fare nulla che induca gli utenti ad abbandonare la riunione, ad esempio aggiornare il browser.
Se utilizzi l'esperienza multigiocatore, il componente aggiuntivo deve consentire a tutti i partecipanti di collaborare ai contenuti anche se le autorizzazioni non sono impostate in anticipo. La modifica delle autorizzazioni deve essere disponibile durante la sessione del componente aggiuntivo collaborativo.
Il componente aggiuntivo deve gestire l'annullamento del flusso di avvio dell'attività e consentire all'utente di riavviare l'attività dall'app.
Il componente aggiuntivo deve fornire un riquadro laterale per l'accesso e la configurazione dell'esperienza di attività.
Il componente aggiuntivo non deve fornire funzionalità per invitare un bot o fare affidamento sulla presenza di un bot nella riunione
Componente aggiuntivo di Google Workspace
Esperienza utente
Il componente aggiuntivo ha una home page. Se il componente aggiuntivo Google Workspace è un
componente aggiuntivo Gmail convertito, viene applicata una home page predefinita.
L'elemento UI (ad esempio una scheda del componente aggiuntivo o una UI incorporata in un iframe nei componenti aggiuntivi di Meet) funziona correttamente. Ad esempio, non
ci sono elementi duplicati; i pulsanti Indietro, Aggiorna e Aggiornamento funzionano
di conseguenza.
Dopo che l'utente ha autorizzato il componente aggiuntivo, vengono visualizzate informazioni (ad esempio una scheda della home page personalizzata o una pagina web nei componenti aggiuntivi di Meet) per dare il benvenuto all'utente con un pulsante di accesso (se necessario), il logo e una breve descrizione del componente aggiuntivo.
Se viene attivato il pulsante di accesso, viene visualizzata
una pagina di accesso personalizzata del fornitore di terze parti che indica chiaramente
che è in funzione un servizio di terze parti esterno a
Google Workspace.
L'interfaccia utente del componente aggiuntivo si adatta perfettamente agli spazi allocati:
Testo ed etichette non vengono troncati con "..."
L'utente non deve scorrere molto in verticale.
La larghezza dei contenuti non supera i 300 pixel, in modo da non
avere una barra di scorrimento orizzontale.
Il codice del componente aggiuntivo non utilizza librerie in modo eccessivo, in quanto
le librerie possono causare un calo delle prestazioni del componente aggiuntivo.
Componenti aggiuntivi per Calendar
Se il componente aggiuntivo fornisce soluzioni per le conferenze, le conferenze
create sono valide e visualizzate correttamente sul sito web
di conferenze di terze parti.
Componenti aggiuntivi di Documenti
Se il componente aggiuntivo visualizza l'anteprima dei link di un dominio di terze parti (smart chip):
Le anteprime dei link offrono all'utente informazioni pertinenti e supplementari.
Ad esempio, l'anteprima di un link a un'offerta di vendita aggiunge
informazioni come account, importo e fase.
Lo sviluppatore è affiliato al dominio visualizzato in anteprima (il pattern URL specificato che attiva la creazione dello smart chip).
Se l'app archivia i file in Drive, consente agli utenti
di scegliere una cartella
o crea e riutilizza una cartella specifica dell'app. I dati di configurazione possono
essere archiviati in una cartella Dati app. L'app non scarica i 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 a estensioni del browser Chrome senza giustificazione.
Il menu Altre azioni more_vert
contiene azioni universali che funzionano correttamente. Ad esempio, Esci, Informazioni, Assistenza e così via.
Componenti aggiuntivi di Meet
Se il componente aggiuntivo richiede una licenza o un abbonamento: all'utente deve essere mostrato un messaggio intuitivo quando non dispone di una licenza.
Se l'utente non può utilizzare il componente aggiuntivo a causa di un problema di licenza, il messaggio di errore deve indicare chiaramente il motivo per cui non può essere utilizzato e suggerire un corso d'azione per risolvere la situazione.
La scheda del componente aggiuntivo su Google Workspace Marketplace deve specificare i dettagli sui requisiti di licenza e abbonamento che potrebbero essere necessari per utilizzare il componente aggiuntivo. Se il componente aggiuntivo ha un livello a pagamento, la scheda del Marketplace deve fornire un link a una pagina web che offre maggiori informazioni sui prezzi o su come contattare un venditore.
Se l'utente non ha ancora eseguito l'accesso, il componente aggiuntivo deve presentare la richiesta di accesso One Tap disponibile in Visualizzare Google One Tap e un fallback "Accedi con Google" disponibile in Autenticazione. Oltre al meccanismo "Accedi con Google", potrebbero essere offerte altre opzioni di accesso.
Il componente aggiuntivo deve avere un design adattabile in grado di adattare i contenuti a dimensioni diverse.
I percorsi utente del componente aggiuntivo devono essere funzionali anche se i cookie di terze parti sono disattivati.
Il componente aggiuntivo non deve avere uno scorrimento orizzontale all'interno dell'iframe.
Se un componente aggiuntivo vuole utilizzare il palco principale, deve essere progettato per esperienze multigiocatore e consentire la manipolazione dei contenuti da parte di più partecipanti contemporaneamente. Per le esperienze per giocatore singolo, lo sviluppatore deve utilizzare il riquadro laterale.
(consigliato) Il componente aggiuntivo deve mostrare l'utente che ha eseguito l'accesso.
(consigliato) Scelta della localizzazione: la lingua deve basarsi sulla preferenza locale impostata dal browser, se disponibile.
(Consigliato) La selezione dei contenuti deve avvenire tramite un'interfaccia di navigazione dei contenuti con i contenuti a cui è stato eseguito l'accesso di recente.
(Consigliato) Se il riquadro laterale non è più necessario, il componente aggiuntivo deve chiuderlo dopo l'avvio nella fase principale.
Se il componente aggiuntivo utilizza calendar.conferenceSolution, il
logo della soluzione per conferenze segue i
requisiti calendar.logoUrl. Vedi
Risorsa manifest del calendario.
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/
Componenti aggiuntivi di Meet
Il logo del brand del componente aggiuntivo deve avere dimensioni e stile tali da essere identificabile nel riquadro laterale di Meet.
Gli URL dei loghi adatti alla modalità Buio devono essere specificati nel manifest del componente aggiuntivo
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 indirizza a un'app web. Una semplice
pagina web senza funzionalità non è considerata un'app web.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-30 UTC."],[[["Google Workspace Marketplace app reviews focus on design, content, functionality, and user experience to ensure compliance with platform standards."],["Common reasons for app rejection include incomplete OAuth verification, inaccurate app listings, and functionality issues."],["Apps must have clear, concise names, detailed descriptions, bug-free functionality, and intuitive user interfaces."],["Specific requirements exist for Google Chat, Google Drive, and Editor add-ons to ensure seamless integration with respective services."],["Developers should follow detailed guidelines for graphics, OAuth scopes, and platform-specific functionalities to enhance user experience and app quality."]]],["Developers submitting apps to the Google Workspace Marketplace must undergo a review process. The app's name, developer information, and description must be accurate and follow specific guidelines. The app must be fully functional, bug-free, and offer a positive user experience. Graphics, including icons and screenshots, must be high-quality and relevant. OAuth verification and scope usage must be correct. Specific requirements exist for Google Chat, Drive, Editor, and Workspace add-ons, focusing on functionality, user experience, and graphics. Apps can be approved or require resubmission based on the review.\n"]]
