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 la tua app e la relativa scheda per assicurarsi che soddisfino le linee guida di Google relative a design, contenuti e stile.
Dopo che Google ha esaminato la tua app, riceverai un'email per sapere se è necessario apportare ulteriori modifiche o se è stata approvata.
Se la tua app richiede ulteriori interventi: riceverai un documento di revisione con informazioni specifiche su ciò che deve essere migliorato. Risolvi i problemi e
invia nuovamente 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
La quantità di lavoro aggiuntivo necessaria per 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 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 con precisione le funzionalità dell'app.
Idoneità dell'app:
L'app è ancora in fase di test e non è disponibile pubblicamente.
L'app presenta bug o non è completamente funzionale.
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 visualizzato nella schermata di consenso OAuth.
Il nome non è vago o troppo generico.
Il nome deve contenere al massimo 50 caratteri.
(consigliato) Il nome utilizza l'iniziale maiuscola.
(Consigliato) Il nome non contiene punteggiatura,
in particolare parentesi.
(consigliato) Il nome corrisponde a quello visualizzato nelle applicazioni Google Workspace. Ad esempio, in Componenti aggiuntivi di Google Workspace, il nome nel file 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 commerciante
su Google Workspace Marketplace è un commerciante o un
non commerciante:
Trader: una persona che agisce per scopi relativi a un'attività commerciale, imprenditoriale, artigianale o professionale oppure 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
dell'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 a norme sulla privacy rimanda 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 l'app interagisce con esso e, facoltativamente, i link 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) 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 gli 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 è pensata per scopi di test. Non è in fase di sviluppo.
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
il Single Sign-On (SSO) con un solo clic o, idealmente, il Single Sign-On (SSO) senza clic.
Dopo che un amministratore ha concesso le autorizzazioni per gli ambiti OAuth 2.0 per il dominio, ai singoli utenti non verrà più chiesto di concedere le autorizzazioni per gli ambiti.
Gli utenti non devono inserire le credenziali dopo aver eseguito l'accesso al proprio Account Google. Al massimo, deve fare clic su un pulsante "Accedi con Google" per ottenere l'accesso.
Sono presenti termini coerenti, evidenti e comprensibili per etichette dei pulsanti, voci di menu, titoli e altri elementi dell'app. Ad esempio, anziché
Sì o No, le etichette fanno riferimento a nomi di azioni come Elimina e Annulla.
Se è richiesto l'accesso, la funzionalità di logout funziona correttamente.
I token vengono revocati e l'accesso può essere avviato da capo.
Per le azioni viene sempre visualizzato un feedback, ad esempio messaggi di conferma o di errore.
Non ci sono link a immagini non funzionanti o immagini sfocate.
Elementi grafici
Le icone hanno dimensioni corrette, sono quadrate e hanno sfondi trasparenti. Consulta la sezione 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 inappropriate. Rappresentano con precisione l'app.
(Consigliato) Gli screenshot mostrano chiaramente come utilizzare l'app e che cosa fa.
OAuth
L'app ha superato la verifica OAuth, utilizza gli ambiti OAuth più limitati possibili e tutti gli ambiti si integrano correttamente con le API di Google Services.
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 A-Z (maiuscole) o 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 inizia un messaggio diretto o l'app viene aggiunta a uno spazio. Il messaggio di benvenuto è diverso dal comando "Help". Per ulteriori informazioni, consulta
Creare una home page per un'app Google Chat.
L'app risponde sempre quando le viene rivolto il discorso in uno spazio o in un messaggio diretto di Chat.
I messaggi utilizzano ortografia, punteggiatura, lettere maiuscole e grammatica corrette. I messaggi non contengono materiale dannoso, offensivo o illecito.
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 che spiega il ritardo.
Le app che inviano notifiche consentono agli utenti di disattivarle.
Gli utenti possono aggiungere l'app a uno spazio utilizzando @menzioni.
Gli utenti possono rimuovere l'app da uno spazio utilizzando il menu Visualizza membro.
L'app indica all'utente tutto ciò che è necessario per interagire con essa.
L'app è disponibile nell'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 mostra l'anteprima dei link di un dominio di terze parti:
Le anteprime dei link offrono informazioni aggiuntive pertinenti al messaggio dell'utente. Ad esempio, la visualizzazione di un'anteprima di un link a un deal 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 il codice HTML di Drive.
Se la tua app utilizza ambiti sensibili o con restrizioni, deve essere sottoposta alla verifica OAuth. Consulta la sezione Inviare l'app per la verifica.
Se la tua app utilizza ambiti con restrizioni, deve anche essere sottoposta a una
valutazione della sicurezza. Consulta la sezione Valutazione della sicurezza.
App Google Drive
Esperienza utente
Se l'app archivia i file su Drive, consente agli utenti di scegliere una cartella o di creare e riutilizzare una cartella specifica per l'app. I dati di configurazione possono essere memorizzati in una cartella Dati app. L'app non scarica i file nella
cartella Il mio Drive dell'utente.
L'app archivia in Drive solo i file collegati alla funzionalità documentata dell'app.
Componente aggiuntivo Editor
Funzionalità
Il componente aggiuntivo include le azioni previste e richieste e fornisce tutti gli strumenti necessari per completare il flusso di lavoro. Ad esempio:
Se il componente aggiuntivo applica gli stili all'intero documento, offre la possibilità di applicarli solo al testo selezionato.
Se il componente aggiuntivo carica i dati del foglio di lavoro in un feed del servizio web,
ha un link a quel feed per una facile navigazione.
Se il componente aggiuntivo richiede all'utente di avere 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 è costituito solo da funzioni personalizzate, include comunque la documentazione appropriata.
Il componente aggiuntivo utilizza correttamente onInstall() e
onOpen() per compilare il menu. Gli elementi del menu vengono compilati
quando il componente aggiuntivo viene installato per la prima volta e quando viene aperto un altro file. Consulta
Autorizzazione del componente aggiuntivo Editor.
Il componente aggiuntivo deve essere implementato nel runtime V8 di Apps Script. Per ulteriori informazioni, consulta
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 su come utilizzarlo.
Il codice del componente aggiuntivo non utilizza eccessivamente le librerie, poiché
le librerie possono causare una perdita di prestazioni del componente aggiuntivo.
Gli errori vengono evitati, se possibile, e gestiti correttamente, in caso contrario:
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.
Se possibile, se l'utente sta facendo qualcosa di sbagliato, viene visualizzato un pulsante che consente di risolvere 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:
Il testo e le etichette non vengono tagliati con "…"
L'utente non deve eseguire molto scorrimento verticale.
La larghezza dei contenuti non supera i 300 pixel, in modo che non sia presente
una barra di scorrimento orizzontale.
Il componente aggiuntivo richiede 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 al design.
Ad esempio, un componente aggiuntivo di Fogli Google che importa dati
comporta 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ù azioni 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 di Calendar
Se il componente aggiuntivo utilizza calendar.name o
common.name, il nome nel file manifest è identico al
nome fornito nella scheda dell'app.
Se il componente aggiuntivo utilizza calendar.conferenceSolution, il
nome della soluzione per le conferenze non deve contenere "Google Calendar".
(consigliato) Se il componente aggiuntivo utilizza
calendar.conferenceSolution, il nome della soluzione per le conferenze
non deve superare i 30 caratteri.
Componente aggiuntivo di Google Workspace
Funzionalità
Il componente aggiuntivo utilizza l'elemento UI corretto (ad esempio
i widget o l'interfaccia utente in iframe nei componenti aggiuntivi di Meet) per la funzionalità desiderata. Ad esempio, utilizza un pulsante di attivazione/disattivazione per selezionare un valore booleano.
Componenti aggiuntivi di Calendar
I calendari secondari e la delega sono supportati o, se non supportati, gestiti in modo corretto. Ad esempio, la creazione della conferenza
non fallisce 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 videoconferenza, vengono utilizzati i campi di dati delle conferenze 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 sono forniti nel campo delle note.
Se il componente aggiuntivo fornisce soluzioni per le conferenze, modifica solo i dettagli della conferenza e nessun altro campo dell'evento.
Se il componente aggiuntivo fornisce soluzioni per le 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.
Il dominio completo è specificato.
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
Le procedure di accesso e di navigazione dell'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 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 multiplayer, 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'avvio dell'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 di Gmail convertito, viene applicata una home page predefinita.
L'elemento dell'interfaccia utente (ad esempio una scheda del componente aggiuntivo o un'interfaccia utente in iframe nei componenti aggiuntivi di Meet) funziona correttamente. Ad esempio, non esistono elementi duplicati; i pulsanti Indietro, Aggiorna e Aggiorna 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 per accedere (se necessario), il 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 esiste un servizio di terze parti che funziona al di fuori di
Google Workspace.
L'interfaccia utente del componente aggiuntivo si adatta perfettamente agli spazi allocati:
Il testo e le etichette non vengono tagliati con "…"
L'utente non deve eseguire molto scorrimento verticale.
La larghezza dei contenuti non deve superare i 300 pixel, in modo che non sia presente
una barra di scorrimento orizzontale.
Il codice del componente aggiuntivo non utilizza eccessivamente le librerie, poiché
le librerie possono causare una perdita di prestazioni del componente aggiuntivo.
Componenti aggiuntivi di Calendar
Se il componente aggiuntivo fornisce soluzioni per le conferenze, le conferenze
create sono valide e visualizzate correttamente sul sito web di terze parti
per le conferenze.
Componenti aggiuntivi di Documenti
Se il componente aggiuntivo mostra l'anteprima dei link di un dominio di terze parti (smart chip):
Le anteprime dei link offrono all'utente informazioni supplementari pertinenti.
Ad esempio, la visualizzazione di un link a un deal 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 su Drive, consente agli utenti di scegliere una cartella o crea e riutilizza una cartella specifica per l'app. I dati di configurazione possono essere memorizzati in una cartella Dati app. L'app non scarica i file nella
cartella Il mio Drive dell'utente.
Il componente aggiuntivo memorizza su Drive solo i file correlati alla funzionalità documentata del componente aggiuntivo.
Componenti aggiuntivi di Gmail
Il componente aggiuntivo non menziona né rimanda alle estensioni del browser Chrome senza giustificazione.
Il menu Altre azioni more_vert
contiene azioni universali che funzionano correttamente. Ad esempio, Uscire, Informazioni, Assistenza e così via.
Componenti aggiuntivi di Meet
Se il componente aggiuntivo richiede una licenza o un abbonamento: deve essere mostrato un messaggio intuitivo all'utente se 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 è possibile utilizzarlo e suggerire un'azione per risolvere il problema.
La scheda di Google Workspace Marketplace del componente aggiuntivo deve specificare i dettagli dei 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 offra ulteriori informazioni sui prezzi o su come contattare un addetto alle vendite.
Se l'utente non ha ancora eseguito l'accesso, il componente aggiuntivo deve presentare la richiesta di accesso One Tap disponibile in Mostra One Tap di Google e un'opzione di riserva "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 responsive che possa adattare i contenuti a dimensioni diverse.
I percorsi utente dei componenti aggiuntivi devono essere funzionali anche se i cookie di terze parti sono disattivati.
Il componente aggiuntivo non deve avere scorrimento orizzontale all'interno dell'iframe.
Se un componente aggiuntivo vuole utilizzare la fase principale, deve essere progettato per esperienze multiplayer 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 dovrebbe mostrare chi è l'utente che ha eseguito l'accesso.
(consigliato) Scelta di localizzazione: la lingua deve essere basata sulla preferenza locale impostata dal browser, se disponibile.
(Consigliato) La selezione dei contenuti deve avvenire tramite un'interfaccia di navigazione dei contenuti che mostri i contenuti a cui è stato effettuato l'accesso di recente.
(Consigliato) Se il riquadro laterale non è più necessario, il componente aggiuntivo deve chiuderlo dopo il lancio nella fase principale.
Se il componente aggiuntivo utilizza calendar.conferenceSolution, il logo della soluzione per conferenze deve soddisfare i requisiti di 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 con limitazioni,
il componente aggiuntivo include l'ambito
drive.addons.metadata.readonly.
App web
Funzionalità
L'URL di navigazione universale rimanda 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-03-06 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"]]
