Informazioni sulla revisione delle app

Se vuoi rendere pubblica la tua app, Google deve esaminarla prima che venga pubblicata per verificare che sia conforme alle linee guida relative a design, contenuti e stile di Google.

Dopo che Google avrà esaminato la tua app, riceverai un'email che spiega se ha bisogno di ulteriore lavoro o se viene approvata.

  • Se la tua app richiede ulteriore lavoro: riceverai un documento di recensione 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 riceverai un'email di notifica.

Durata revisione

La durata della revisione dipende dal numero di app inviate di recente e dal numero di correzioni necessarie. Non è raro che la revisione richieda diversi giorni.

Aree di revisione

Google utilizza le seguenti linee guida per esaminare la tua app. Prima di inviare l'app per la revisione, assicurati che l'app soddisfi tutte le linee guida e sia conforme alle norme del programma Google Workspace Marketplace.

Per conoscere i motivi per cui le app vengono rifiutate di frequente, consulta Motivi comuni per cui l'app non è pronta.

Integrazione app Categoria Criteri
Tutte Nome app
  • Non ci sono altre schede dell'app con lo stesso nome.
  • Il nome non include un numero di versione.
  • Il nome corrisponde al nome riportato sulla schermata per il consenso OAuth.
  • Il nome non è vago o troppo generico.
  • Il nome può contenere al massimo 50 caratteri.
  • (Consigliato) Il nome utilizza la maiuscola per il titolo.
  • (Consigliato) Il nome non contiene punteggiatura, soprattutto tra parentesi.
Tutte Nome sviluppatore
  • Il nome e il sito web dello sviluppatore rappresentano in modo accurato e indirizzano a informazioni pertinenti lo sviluppatore.
Tutte Descrizione applicazione
  • Tutti i link forniti funzionano e rimandano alle informazioni corrette. Ad esempio, un link alle 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, in che modo interagisce con l'app e, facoltativamente, rimanda al sito web pertinente.
  • Le descrizioni brevi e dettagliate sono facili da capire.
  • Le descrizioni brevi e dettagliate non sono identiche.
  • (Consigliato) Le informazioni sui prezzi sono complete e accurate.
  • (Consigliato) L'insieme completo degli attributi per lingua (nome, descrizione breve e descrizione dettagliata) sono definiti correttamente senza mancata corrispondenza della lingua.
Tutte Funzionalità
  • Non ci sono bug evidenti e tutte le azioni, inclusi i casi limite, sono perfettamente funzionanti. I tempi di caricamento vengono gestiti con gli indicatori di caricamento.
  • L'app dimostra interazioni chiare con le API di Google.
  • L'app offre una funzionalità nuova o estesa che non è equivalente a quella già inclusa nei prodotti Google.
  • L'app non è destinata a scopi pubblicitari o di spam.
  • L'app è completamente funzionale e non è destinata ai test e non è un lavoro in corso.
  • Se l'app interagisce con funzionalità disponibili per gli utenti o per gli utenti paganti, per il team di revisione di Google viene fornito un account di prova sul sistema dello sviluppatore.
Tutte Esperienza utente
  • L'app, incluso il nome, non utilizza gli asset del brand, i marchi o i contenuti brandizzati di Google. Consulta le linee guida per il branding di Google Workspace Marketplace.
  • Autorizzazione e accesso sono richiesti una sola volta. L'app utilizza SSO a un clic o, idealmente, zero-click SSO.
  • Dopo che un amministratore ha concesso le autorizzazioni per gli ambiti Oauth 2.0 per il dominio, le singole autorizzazioni non saranno più richieste ai singoli utenti.
  • 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".
  • Esistono termini coerenti, evidenti e comprensibili per etichette dei pulsanti, voci del menu, titoli e così via. Ad esempio, invece di Sì o No, le etichette si riferiscono ai 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ò ricominciare dall'inizio.
  • Il feedback viene sempre visualizzato, ad esempio i messaggi di conferma o di errore, per le azioni.
  • Non ci sono link a immagini inaccessibili o immagini sfocate.
Tutte Elementi grafici
  • Le icone sono dimensionate correttamente, quadrate e hanno sfondi trasparenti. Consulta 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 i marchi di Google.
  • Screenshot e immagini non sono sfocati, difficili da leggere o inappropriati. Rappresentano accuratamente l'app.
  • (Consigliato) Gli screenshot mostrano chiaramente come utilizzare l'app e la sua funzione.
Tutte OAuth
  • L'app ha superato la verifica OAuth, utilizza gli ambiti OAuth più ristretti possibile e tutti gli ambiti si integrano correttamente con le API Google Services.
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 "Guida". Per maggiori informazioni su come creare un messaggio di benvenuto efficace, consulta la pagina Creare app di chat che aiutano e intrattengono gli utenti.
  • L'app supporta il comando "Guida" e aiuta gli utenti a iniziare a utilizzare l'app. Per ulteriori informazioni su come creare un buon messaggio di assistenza, consulta la sezione Creare app di chat che aiutano e intrattengono gli utenti.
  • L'app risponde sempre quando viene parlata in uno spazio o in una chat diretta.
  • I messaggi utilizzano ortografia, maiuscole, punteggiatura e grammatica corrette, e 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 disattivare le notifiche.
  • 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 con l'app.
  • Il formato delle schede utilizzato dall'app soddisfa i requisiti di Google. Consulta la pagina Creare schede interattive.
  • L'app è disponibile nell'opzione Trova app nel menu Chat.
  • Gli URL esterni con cui l'app interagisce e non appartengono a un ambiente di gestione temporanea o di sviluppo.
  • La @menzione è obbligatoria in tutti i messaggi inviati all'app negli spazi. Questo è l'unico modo in cui l'app sa che deve rispondere.
App Google Chat Elementi grafici
  • L'app ha un avatar chiaro e riconoscibile.
App Google Chat Anteprime link
  • L'anteprima dei link offre informazioni supplementari pertinenti al messaggio dell'utente. Ad esempio, l'anteprima di un link a un deal di vendita aggiunge informazioni come account, importo e fase.
  • Lo sviluppatore è affiliato al dominio in anteprima.

Per ulteriori informazioni sulla configurazione dell'anteprima dei link, consulta la sezione Anteprima dei link.

App Google Drive Funzionalità
  • L'app non utilizza le estensioni di Google Chrome per fornire funzionalità modificando 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 Come faccio a richiedere la verifica.
  • Se la tua app utilizza ambiti con restrizioni, deve essere sottoposta anche a un test di sicurezza. Consulta la sezione Perché è necessaria la valutazione della sicurezza.
App Google Drive Esperienza utente
  • Se l'app archivia i file in 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 archiviati in una cartella di dati delle app. L'app non scarica i file nella cartella Il mio Drive dell'utente.
  • L'app archivia solo i file su Drive collegati alla funzionalità documentata dell'app.
Componente aggiuntivo Editor Funzionalità
  • Le azioni previste e obbligatorie sono incluse nel componente aggiuntivo e forniscono tutti gli strumenti necessari per completare il flusso di lavoro. Ad esempio:
    • Se il componente aggiuntivo applica uno 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 un servizio web, dispone di un link a tale 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 è solo funzioni personalizzate, include comunque la documentazione corretta.
  • Il componente aggiuntivo utilizza 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 di Editor.
  • Le modalità di autorizzazione sono configurate correttamente. Vedi Modalità di autorizzazione.
Componente aggiuntivo Editor Esperienza utente
  • Il componente aggiuntivo fornisce tutte le informazioni necessarie per avere una comprensione di base del prodotto e come utilizzarlo.
  • Il codice del componente aggiuntivo non utilizza eccessivamente le librerie perché tali librerie possono causare una perdita di prestazioni.
  • 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 nella barra rossa predefinita. Comunicano il problema e descrivono ciò che l'utente deve fare per risolverlo in un linguaggio semplice.
    • Quando possibile, se l'utente sta facendo qualcosa di sbagliato, viene visualizzato un pulsante che risolve il problema.
    • Per maggiori informazioni, consulta la guida di stile dei componenti aggiuntivi.
  • I link alle pagine esterne si aprono in nuove finestre e sono corretti.
  • Il componente aggiuntivo è intuitivo e progettato correttamente. Ciò significa che:
    • È sempre chiaro cosa fare e come farlo.
    • Il componente aggiuntivo è accessibile e facile da capire. Evita termini tecnici e tecnicismi.
    • I flussi di lavoro sono chiari e semplificati il più possibile.
    • L'utente e i suoi contenuti sono il più sicuri possibile.
  • Il componente aggiuntivo segue la guida di stile per i componenti aggiuntivi dell'editor e utilizza il pacchetto CSS per i componenti aggiuntivi dell'editor.
  • Il componente aggiuntivo utilizza solo un'azione principale blu per visualizzazione.
  • Il componente aggiuntivo visualizza una finestra di dialogo alla volta. Non si sovrappone o ha più finestre di dialogo aperte contemporaneamente.
  • L'interfaccia utente del componente aggiuntivo è ordinata negli spazi assegnati:
    • Il testo e le etichette non vengono tagliati con "..."
    • L'utente non deve eseguire molte operazioni di scorrimento verticale.
    • La larghezza dei contenuti non si estende a oltre 300p in modo che non abbia 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 in un foglio di lavoro, l'utente viene avvisato e conferma l'azione prima che si verifichi.
    • Le modifiche al design possono eliminare la necessità di problemi come questi. Ad esempio, un componente aggiuntivo di Fogli Google che importa dati crea un rischio di sovrascrittura dei contenuti esistenti. Il rischio può essere completamente rimosso 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 di conferenza non contiene"Google Calendar".
  • (Consigliato) Se il componente aggiuntivo utilizza calendar.conferenceSolution, il nome della soluzione per conferenze non supera 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)
    • Sono supportati anche calendari secondari e delega, se non sono supportati. Ad esempio, la creazione di conferenze ha esito negativo 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 campi di dati della conferenza appropriati. Ad esempio, link di videoconferenze, numeri di telefono, link SIP, codici di accesso e altri attributi supportati utilizzano campi di dati strutturati e non vengono forniti nel campo delle note.
    • Il componente aggiuntivo fornisce soluzioni per conferenze, ma 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.
      • È stato specificato il dominio completo.
      • Il percorso non è vuoto. Ad esempio, https://altostrat/ va bene, ma 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 tuo componente aggiuntivo di Google Workspace è un componente aggiuntivo di Gmail convertito, viene applicata una home page predefinita.
  • La scheda aggiuntiva funziona correttamente. Ad esempio, non ci sono schede duplicate; i pulsanti Indietro, Aggiorna e Aggiorna funzionano di conseguenza.
  • Dopo che l'utente autorizza il componente aggiuntivo, viene visualizzata una home page personalizzata per accogliere l'utente con un pulsante per l'accesso (se necessario), il logo e una breve descrizione del componente.
    • Se il pulsante di accesso viene attivato, viene visualizzata una pagina di accesso personalizzata del fornitore di terze parti che indica chiaramente che c'è un servizio di terze parti che funziona al di fuori di Google Workspace.
  • L'interfaccia utente del componente aggiuntivo è ordinata negli spazi assegnati:
    • Il testo e le etichette non vengono tagliati con "..."
    • L'utente non deve eseguire molte operazioni di scorrimento verticale.
    • La larghezza dei contenuti non si estende a oltre 300p in modo che non abbia una barra di scorrimento orizzontale.
  • Il codice del componente aggiuntivo non utilizza eccessivamente le librerie perché tali librerie possono causare una perdita di prestazioni.
(Componenti aggiuntivi di Calendar)
  • Se il componente aggiuntivo fornisce soluzioni per conferenze, quelle che vengono create sono valide e vengono visualizzate correttamente sul sito web di terze parti per le conferenze.
(Componenti aggiuntivi per Drive)
  • Se l'app archivia i file in 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 archiviati in una cartella di dati delle app. L'app non scarica i file nella cartella Il mio Drive dell'utente.
  • Il componente aggiuntivo archivia solo i file su Drive che sono collegati alla funzionalità documentata del componente aggiuntivo.
(Componenti aggiuntivi di Gmail)
  • Il componente aggiuntivo non menziona né collega a estensioni di 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 conferenze è un URL pubblico. Consulta Fornisci i loghi delle soluzioni per conferenze.
  • Se il componente aggiuntivo utilizza calendar.conferenceSolution, il logo della soluzione per conferenze segue i requisiti calendar.logoUrl. Vedi Risorsa manifest di Calendar.
  • Se il componente aggiuntivo utilizza calendar.logoUrl o common.logoUrl, il logo è identico all'icona presente 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 semplice pagina web senza funzionalità non è considerata un'app web.

Motivi comuni per cui la tua app non è pronta

Verifica OAuth

  • La schermata per il consenso OAuth non è 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.

Scheda dell'app

  • Uso inappropriato dei marchi di Google nel nome, nel logo o nelle descrizioni delle 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 sono di bassa qualità o non rappresentano accuratamente la funzionalità dell'app.

Preparazione dell'app

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