Procedura di revisione delle app e requisiti per Google Workspace Marketplace

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

Dopo che Google avrà esaminato la tua app, riceverai un'email che ti comunicherà se è necessaria ulteriori operazioni o se è stata approvata.

  • Se la tua app richiede lavoro aggiuntivo: ricevi un documento di revisione con informazioni specifiche su ciò che deve essere migliorato. Risolvi i problemi e invia di nuovo l'app per la revisione.
  • Se il team di revisione approva la tua app: questa viene pubblicata automaticamente e ricevi un'email di notifica.

Prima di inviare l'app per la revisione, assicurati che sia pronta per la pubblicazione. Per maggiori dettagli, vedi Prepararsi per il processo di pubblicazione.

Durata della revisione

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

  • Quante app sono state inviate di recente
  • Quanto lavoro aggiuntivo ha bisogno la tua app

Motivi comuni per cui un'app non supera il controllo

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:

  • Utilizzo 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 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 le funzionalità dell'app.

Preparazione dell'app:

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

Criteri di revisione

Prima di inviare l'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

Puoi utilizzare le caselle di controllo per tenere traccia della revisione preliminare.

Categoria Criteri
Nome dell'app
  • Non ci sono 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 può contenere al massimo 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 sullo sviluppatore e le indirizzano a informazioni pertinenti.
  • Ai sensi delle leggi per la tutela dei consumatori, i consumatori che risiedono nello Spazio economico europeo (SEE) devono sapere 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à commerciale, un mestiere o una professione oppure in nome o per conto di un commerciante.
    • Non commerciante: non commerciante (consumatore) si intende una persona che agisce per scopi non professionali.

    Se il valore non è specificato, nella pagina della 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, un link alle norme sulla privacy rimanda a una pagina che le descrive.
  • Se l'app interagisce con un servizio di terze parti, la descrizione descrive ciò che fa questo servizio, 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) L'insieme completo di attributi per lingua (nome, descrizione breve e descrizione dettagliata) è definito correttamente senza discordanti di lingua.
Funzionalità
  • Non ci sono bug evidenti e tutte le azioni, inclusi i casi limite, sono completamente funzionali. I tempi di caricamento sono 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 è equivalente a quella già inclusa nei prodotti Google.
  • L'app non è concepita per scopi pubblicitari o di invio di spam.
  • L'app è completamente funzionale e non è destinata a scopi di test: non è una funzionalità in fase di sviluppo.
  • Se l'app interagisce con funzionalità disponibili per gli utenti o gli utenti paganti, viene fornito un account di prova nel sistema dello sviluppatore al team di revisori di Google.
Esperienza utente
  • L'app, incluso il nome, non utilizza gli asset del brand, i marchi o i contenuti con brand Google di Google. Consulta le linee guida per il branding di Google Workspace Marketplace.
  • L'autorizzazione e l'accesso sono necessari una sola volta. L'app utilizza il servizio SSO con un solo clic o, idealmente, con zero clic.
  • Dopo che un amministratore concede le autorizzazioni per gli ambiti OAuth 2.0 per il dominio, ai singoli utenti non vengono richieste di nuovo 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 sul pulsante "Accedi con Google" per ottenere l'accesso.
  • Esistono termini coerenti, ovvi e comprensibili per le etichette dei pulsanti, le voci del menu, i 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.
  • Per le azioni viene sempre visualizzato il feedback, ad esempio i messaggi di conferma o di errore.
  • Non sono presenti link immagine inaccessibili o immagini incomplete.
Elementi grafici
  • Le icone vengono dimensionate correttamente, quadrate e hanno sfondi trasparenti. Vedi Risorse grafiche.
  • L'icona rappresenta correttamente il nome o la funzionalità dell'app.
  • L'icona è a colori (non in scala di grigi).
  • L'icona non utilizza marchi di Google.
  • Gli screenshot e le immagini non sono sfocate, difficili da leggere o inappropriate. Rappresentano con precisione l'app.
  • (Consigliato) Gli screenshot mostrano chiaramente come utilizzare l'app e a cosa serve.
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 tenere traccia della 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 A-Z (maiuscole) o 0-9. Non può iniziare con un simbolo.
App Google Chat Esperienza utente
  • L'app invia un messaggio di benvenuto senza richiesta 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 saperne di più su come creare un messaggio di benvenuto efficace, consulta la pagina Creare app di chat che aiutano e apprezzano gli utenti.
  • L'app supporta il comando "Help" e aiuta gli utenti a iniziare a utilizzarla. Per ulteriori informazioni su come creare un messaggio di assistenza efficace, vedi Creare app di chat che aiutano e apprezzano gli utenti.
  • L'app risponde sempre quando parla in uno spazio o in Chat diretta.
  • I messaggi utilizzano ortografia, lettere maiuscole, punteggiatura e grammatica corrette e 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 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 tramite l'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. Questo è 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 supplementari rispetto 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 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 funzionalità tramite la manipolazione diretta del codice HTML di Drive.
  • Se la tua app utilizza ambiti sensibili o con restrizioni, deve essere sottoposta alla verifica OAuth. Consulta la sezione Come inviare il modulo per 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 crea e riutilizza 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 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 applicare lo stile solo al testo selezionato.
    • Se il componente aggiuntivo carica i dati del foglio di lavoro in un feed di servizio web, avrà un link al 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 presenta voci di menu nella scheda Componenti aggiuntivi.
  • Anche se il componente aggiuntivo è solo funzioni personalizzate, include comunque la documentazione appropriata.
  • Il componente aggiuntivo usa correttamente onInstall() e onOpen() per completare il menu. Le voci di menu si completano 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.
Componente aggiuntivo Editor Esperienza utente
  • Il componente aggiuntivo fornisce tutte le informazioni necessarie per una conoscenza di base del prodotto e di come utilizzarlo.
  • Il codice del componente aggiuntivo non utilizza eccessivamente librerie poiché le librerie possono causare la perdita delle 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 commettendo 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 progettato in modo accurato. Ciò significa che:
    • È sempre chiaro cosa fare e come farlo.
    • Il componente aggiuntivo è accessibile e semplice da capire. È da evitare termini tecnici e gergali.
    • I flussi di lavoro sono il più possibile chiari e facilitati.
    • L'utente e i suoi contenuti siano 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 visualizzazione.
  • Il componente aggiuntivo mostra una finestra di dialogo alla volta. Non si sovrappone a nessuna finestra e non 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 molto in verticale.
    • La larghezza dei contenuti non si estende oltre i 300p, perciò non dispone di 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 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 eliminare 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 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 per conferenze non supera 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 la delega sono supportati o, se non supportati, vengono gestiti normalmente. Ad esempio, la creazione di una conferenza non riesce 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 per le conferenze.
  • Se il componente aggiuntivo fornisce soluzioni per conferenze, vengono utilizzati i campi dei dati relativi alle conferenze appropriati. Ad esempio, i link alle videoconferenze, i numeri di telefono, i link SIP, i codici di accesso e altri attributi supportati utilizzano 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 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, non HTTP.
  • È specificato il dominio completo.
  • Il percorso non è vuoto. Ad esempio, https://altostrat/ va bene, ma https://altostrat non lo è.
  • Impossibile utilizzare i caratteri jolly in UrlFetchApp.
Componente aggiuntivo di Google Workspace Esperienza utente
  • Il componente aggiuntivo ha una home page. Se il tuo 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 ci sono schede duplicate; i pulsanti Indietro, Aggiorna e Aggiorna funzionano di conseguenza.
  • Dopo che l'utente ha autorizzato il componente aggiuntivo, viene visualizzata una scheda della home page personalizzata per accogliere l'utente 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 esiste 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 molto in verticale.
    • La larghezza dei contenuti non si estende oltre i 300 p e pertanto non dispone di una barra di scorrimento orizzontale.
  • Il codice del componente aggiuntivo non utilizza eccessivamente librerie poiché le librerie possono causare la perdita delle prestazioni del componente aggiuntivo.

Componenti aggiuntivi di Calendar

  • Se il componente aggiuntivo fornisce soluzioni per 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 in anteprima link da 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'offerta di vendita aggiunge informazioni come account, importo e fase.
  • Lo sviluppatore è affiliato al dominio in anteprima.

Per maggiori informazioni, consulta la pagina 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 crea e riutilizza 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 connessi alla funzionalità documentata del componente stesso.

Componenti aggiuntivi di Gmail

  • Il componente aggiuntivo non menziona le estensioni del browser Chrome né rimanda a tali estensioni 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 Fornire i loghi delle soluzioni per le conferenze.
  • Se il componente aggiuntivo utilizza calendar.conferenceSolution, il logo della soluzione per conferenze è conforme ai requisiti 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 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.