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 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 informerà se è necessaria ulteriore lavoro o se è stata approvata.

  • Se la tua app richiede ulteriore lavoro: ricevi un documento di revisione con informazioni specifiche sugli aspetti che richiedono miglioramenti. 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.

Prima di inviare l'app per la revisione, assicurati che sia pronta per essere pubblicata. Per maggiori dettagli, consulta Prepararsi alla procedura 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
  • Quanto lavoro aggiuntivo deve essere svolto dalla tua app

Motivi comuni per cui un'app non supera la revisione

Verifica OAuth:

  • La schermata per il consenso OAuth non è stata configurata correttamente. 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 istruzioni, consulta le linee guida per il branding di Google Workspace Marketplace.
  • I link non funzionano o rimandano alle informazioni errate. Ad esempio, un link alle norme sulla privacy rimanda a una pagina di assistenza per gli sviluppatori.
  • Screenshot e immagini di bassa qualità o non rappresentano con precisione 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 funzionale.

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 Google Workspace Marketplace.

Requisiti per tutte le app

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

Categoria Criteri
Nome dell'app
  • Non esistono altre schede di app con lo stesso nome.
  • Il nome non include un numero di versione.
  • Il nome corrisponde a quello visualizzato nella schermata per il consenso OAuth.
  • Il nome non è vago o troppo generico.
  • Il nome non può superare i 50 caratteri.
  • (Consigliato) Il nome usa le iniziali maiuscole.
  • (Consigliato) Il nome non contiene punteggiatura, in particolare le parentesi.
Informazioni sugli sviluppatori
  • Il nome e il sito web dello sviluppatore rappresentano in modo accurato e indirizzano le informazioni pertinenti sullo sviluppatore.
  • Ai sensi delle leggi per la tutela dei consumatori, i consumatori residenti 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, aziendale, artigianale o professionale oppure in 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 Scheda dello Store dell'app viene visualizzato lo"Stato del commerciante non specificato".
Descrizione app
  • Tutti i link forniti funzionano e rimandano alle informazioni corrette. Ad esempio, il link delle 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 tale servizio, come l'app interagisce 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) sono definiti correttamente senza corrispondenza di lingua.
Funzionalità
  • Non ci sono bug evidenti e tutte le azioni, inclusi i casi limite, sono perfettamente funzionanti. I tempi di caricamento vengono gestiti tramite 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 quella già inclusa nei prodotti Google.
  • L'app non è destinata a fini pubblicitari o di spam.
  • L'app è perfettamente funzionante e non è destinata ai test, non è ancora in fase di sviluppo.
  • Se l'app interagisce con funzionalità disponibili per utenti o utenti paganti, il team di revisione di Google fornisce un account di prova sul sistema dello sviluppatore.
Esperienza utente
  • L'app, incluso il nome, non utilizza asset del brand di Google, marchi o contenuti brandizzati Google. Consulta le linee guida per il branding di Google Workspace Marketplace.
  • Autorizzazione e accesso sono richiesti solo una volta. L'app utilizza l'accesso SSO con un solo clic o, idealmente, SSO con un solo clic.
  • Quando un amministratore concede le autorizzazioni per gli ambiti OAuth 2.0 per il dominio, ai singoli utenti non vengono richieste di nuovo le autorizzazioni dell'ambito.
  • Gli utenti non devono inserire le credenziali dopo aver eseguito l'accesso al proprio Account Google. Al massimo, per accedere devono fare clic sul pulsante "Accedi con Google".
  • Esistono termini coerenti, evidenti e comprensibili per le etichette dei pulsanti, le voci di menu, i titoli e altri elementi dell'app. Ad esempio, invece di Sì o No, le etichette fanno riferimento a nomi di azioni come Elimina e Annulla.
  • Se è necessario effettuare l'accesso, la funzionalità di uscita funziona correttamente. I token sono stati revocati e l'accesso può ricominciare dall'inizio.
  • Per le azioni, viene sempre visualizzato il feedback, ad esempio messaggi di conferma o di errore.
  • Non ci sono link immagine inaccessibili o immagini sfocate.
Elementi grafici
  • Le icone sono di dimensioni corrette, quadrate e hanno uno sfondo trasparente. Consulta 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 sfocati, difficili da leggere o inappropriati. Rappresentano con precisione 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ù limitati possibile 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 la lettera A-Z (in lettere maiuscole) o con i numeri da 0 a 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 maggiori informazioni, consulta Inviare un messaggio di scheda della home page dell'app.
  • L'app supporta il comando "Help" (Guida) e aiuta gli utenti a iniziare a utilizzare l'app. Per ulteriori informazioni, consulta Rispondere ai comandi slash.
  • L'app risponde sempre quando si parla in uno spazio o in una chat diretta.
  • I messaggi utilizzano l'ortografia, le lettere maiuscole, la punteggiatura e la grammatica corrette. Non contengono materiale dannoso, offensivo o offensivo.
  • 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 le @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.
  • 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.
  • È necessaria una @menzione in ogni messaggio inviato all'app negli spazi. Solo così l'app sa che deve rispondere.
  • Se l'app Chat mostra l'anteprima dei link da un dominio di terze parti:
    • Le anteprime dei link offrono informazioni pertinenti e supplementari 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 visualizzato in anteprima.

    Per ulteriori informazioni, consulta la sezione Link di 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 alla verifica OAuth. Consulta l'articolo Come richiedere la verifica.
  • Se la tua app utilizza ambiti con restrizioni, deve anche superare una valutazione della sicurezza. Vedi Perché è necessaria la valutazione della sicurezza.
App Google Drive Esperienza utente
  • Se l'app archivia i file su Drive, consente agli utenti di scegliere una cartella oppure di creare e riutilizzare 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 archivia su Drive solo i file collegati alla funzionalità documentata dell'app.
Componente aggiuntivo Editor Funzionalità
  • Le azioni previste e obbligatorie 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 lo stile all'intero documento, offre la possibilità di applicarlo solo al testo selezionato.
    • Se il componente aggiuntivo carica i dati di un foglio di lavoro in un feed di servizi web, avrà un link a quel feed per facilitare 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 compilare il relativo menu. Le voci di menu vengono visualizzate quando il componente aggiuntivo viene installato per la prima volta e quando viene aperto un file diverso. Vedi Autorizzazione dei componenti aggiuntivi Editor.
  • Le modalità di autorizzazione sono impostate correttamente. Vedi Modalità di autorizzazione.
  • Il componente aggiuntivo deve essere implementato nel runtime di V8 di Apps Script. Per maggiori informazioni, 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 eccessivamente le librerie, perché 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 con un linguaggio semplice.
    • Se possibile, se l'utente sta facendo qualcosa di sbagliato, viene visualizzato un pulsante che risolve 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. Evita termini tecnici e tecnici.
    • I flussi di lavoro sono chiari e il più possibile agevolati.
    • L'utente e i suoi contenuti devono essere il più sicuri possibile.
  • Il componente aggiuntivo segue la guida allo 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 o ha più finestre di dialogo aperte alla volta.
  • L'UI del componente aggiuntivo si adatta perfettamente agli spazi allocati:
    • Il testo e le etichette non vengono tagliati con "..."
    • L'utente non deve scorrere troppo 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 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 riceve un avviso e conferma l'azione prima che venga eseguita.

    Puoi evitare questo requisito modificando il design. Ad esempio, un componente aggiuntivo di Fogli Google che importa i dati crea il rischio di sovrascrivere i contenuti esistenti. Puoi eliminare il rischio creando un foglio per i dati come azione predefinita.

  • Gli utenti non possono attivare azioni più volte durante il caricamento. 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 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 per conferenze 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'opzione per selezionare un valore booleano.

Componenti aggiuntivi di Calendar

  • I calendari secondari e le deleghe sono supportati o, se non supportati, vengono gestiti normalmente. Ad esempio, la creazione della conferenza non genera un errore se l'utente seleziona un calendario diverso 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 conferenze.
  • Se il componente aggiuntivo fornisce soluzioni per conferenze, vengono utilizzati i campi appropriati per i dati delle conferenze. Ad esempio, i link alle 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 per conferenze, modifica solo i dettagli della conferenza e nessun altro campo dell'evento.
  • Se il componente aggiuntivo fornisce soluzioni per conferenze, la creazione delle conferenze 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.
  • Viene specificato l'intero dominio.
  • Il percorso non è vuoto. Ad esempio, https://altostrat/ va bene, ma https://altostrat no.
  • 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 del componente aggiuntivo funziona correttamente. Ad esempio, non esistono schede duplicate; i pulsanti Indietro, Aggiorna e Aggiorna funzionano di conseguenza.
  • Dopo che l'utente autorizza il componente aggiuntivo, viene visualizzata una scheda personalizzata della home page con un pulsante di accesso (se necessario), un logo e una breve descrizione del componente aggiuntivo.
    • Se il pulsante di accesso viene attivato, presenta una pagina di accesso personalizzata del fornitore di terze parti che indica chiaramente la presenza di un servizio di terze parti che funziona al di fuori di Google Workspace.
  • L'UI del componente aggiuntivo si adatta perfettamente agli spazi allocati:
    • Il testo e le etichette non vengono tagliati con "..."
    • L'utente non deve scorrere troppo in verticale.
    • La larghezza dei contenuti non si estende oltre 300 p in modo che non abbiano una barra di scorrimento orizzontale.
  • Il codice del componente aggiuntivo non utilizza eccessivamente le librerie, perché può causare una perdita di prestazioni del componente aggiuntivo.

Componenti aggiuntivi di Calendar

  • Se il componente aggiuntivo fornisce soluzioni di conferenza, le conferenze create sono valide e vengono visualizzate correttamente sul sito web di terze parti per conferenze.

Componenti aggiuntivi di Documenti

Se il componente aggiuntivo mostra in anteprima i link da un dominio di terze parti (smart chip):

  • Le anteprime dei link offrono all'utente informazioni aggiuntive e pertinenti. Ad esempio, l'anteprima di un link a un accordo di vendita aggiunge informazioni come account, importo e fase.
  • Lo sviluppatore è affiliato al dominio visualizzato 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, consente agli utenti di scegliere una cartella oppure di creare e riutilizzare 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 alle estensioni del browser Chrome senza giustificazione.
  • Il menu Altre azioni contiene azioni universali che funzionano correttamente. Ad esempio Esci, Informazioni, Assistenza ecc.
Componente aggiuntivo di Google Workspace Elementi grafici

Componenti aggiuntivi di Calendar

  • Il logo della soluzione per videoconferenze è un URL pubblico. Consulta la sezione Fornire i loghi della soluzione per conferenze.
  • Se il componente aggiuntivo utilizza calendar.conferenceSolution, il logo della soluzione per conferenze segue i requisiti di calendar.logoUrl. Vedi 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 seguente: 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 semplice pagina web senza funzionalità non è considerata un'app web.