Procedura di revisione delle app e requisiti per Google Workspace Marketplace

Per pubblicare un'app pubblicamente su Google Workspace Marketplace, Google esamina la tua app e la relativa scheda per assicurarti che soddisfino il design di Google, linee guida sui contenuti e sullo stile.

Dopo che Google avrà esaminato la tua app, riceverai un'email che ti chiede se è necessaria più lavoro o se approvato.

  • Se la tua app richiede lavoro aggiuntivo: riceverai un documento di revisione con informazioni specifiche sugli aspetti che devono essere migliorati. 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 pubblicare. 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 nell'app dell'app descrizioni. Per istruzioni, visita il Linee guida per il branding di Google Workspace Marketplace.
  • I link non funzionano o rimandano alle informazioni errate. Ad esempio, un link per le norme sulla privacy rimanda a una pagina di assistenza per gli sviluppatori.
  • Screenshot e immagini di bassa qualità o non rappresentano con precisione l'app funzionalità.

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 requisiti e sia conforme 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 per gli sviluppatori
  • Il nome e il sito web dello sviluppatore rappresentano in modo accurato e indirizzare gli utenti a informazioni pertinenti sullo sviluppatore.
  • Ai sensi delle leggi per la tutela dei consumatori, i consumatori che risiedono in Nello Spazio economico europeo (SEE) deve essere comunicato se un commerciante su Google Workspace Marketplace sia un commerciante o non commerciante:
    • Commerciante: un commerciante è una persona che agisce per scopi relativi a a un'attività commerciale, artigianale o professionale; o in nome o per conto di di un commerciante.
    • Non commerciante: un non commerciante (consumatore) è una persona che agisce per scopi non professionali.

    Se non specificato, "Stato commerciante non specificato" viene visualizzato nella scheda dello Store .

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 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 e, facoltativamente, si collega 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 accurati.
  • (Consigliato) Il set completo di attributi per lingua (nome, descrizione breve e descrizione dettagliata) sono definite correttamente senza una mancata corrispondenza della lingua.
Funzionalità
  • Non ci sono bug evidenti e tutte le azioni, inclusi i casi limite, sono completamente funzionali. I tempi di caricamento vengono gestiti tramite caricamento indicatori.
  • L'app dimostra interazioni chiare con le API di Google.
  • L'app fornisce una funzionalità nuova o estesa che non è equivalenti a quanto già incluso 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 gli utenti o utenti paganti, un account di prova sul sistema dello sviluppatore fornito al team di revisione di Google.
Esperienza utente
  • L'app, incluso il nome, non utilizza gli asset del brand Google, o contenuti con brand Google. Consulta 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, l'SSO con zero clic.
  • Dopo che un amministratore concede le autorizzazioni per gli ambiti OAuth 2.0 per dominio, ai singoli utenti non vengono richieste le autorizzazioni dell'ambito di nuovo.
  • Gli utenti non devono inserire le credenziali dopo aver eseguito l'accesso il proprio Account Google. Al massimo, deve fare clic sul pulsante "Accedi con Google" per accedere.
  • Esistono termini coerenti, evidenti e comprensibili per etichette di pulsanti, voci di menu, titoli e altri elementi dell'app. Ad esempio, invece di Sì o No, le etichette si riferiscono 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.
  • Viene sempre visualizzato il feedback, ad esempio una conferma o messaggi di errore, per le azioni.
  • Non ci sono link immagine inaccessibili o immagini sfocate.
Elementi grafici
  • Le icone sono di dimensioni corrette, quadrate e sono trasparenti e background. Consulta la sezione Grafica asset.
  • 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.
  • Screenshot e immagini non siano sfocati, difficili da leggere o inappropriato. 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 e utilizza il formato OAuth possibili e che tutti gli ambiti si integrano correttamente con Google API dei servizi.

Requisiti aggiuntivi per integrazioni di app specifiche

Seleziona le integrazioni di app incluse nella scheda dell'app per visualizzare quelle pertinenti criteri di revisione. Puoi fare clic sui nomi delle colonne per ordinare i criteri, ad esempio 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 nell'app o l'audiodescrizione.
  • 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. La un messaggio di benvenuto è diverso dalla "Guida" . Per maggiori informazioni le informazioni, vedi Creare una home page per un'app Google Chat.
  • L'app supporta la "Guida" e aiuta gli utenti a iniziare utilizzando l'app. Per ulteriori informazioni, consulta Rispondi 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 grammaticale. I messaggi non contengono contenuti dannosi, offensivi o illeciti materiale.
  • I messaggi utilizzano una formattazione chiara, concisa e coerente per il testo o carte in base ai requisiti di Google.
  • Se una risposta richiede più di 2 secondi, l'app invia un 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 del membro.
  • L'app indica all'utente tutto il necessario per interagire con loro.
  • Il formato delle schede utilizzato dall'app soddisfa i requisiti di Google. Consulta Crea schede interattive.
  • L'app è disponibile dall'opzione Trova app. nel menu Chat.
  • Gli URL esterni con cui interagisce l'app non appartengono a un di gestione temporanea o di sviluppo.
  • È necessaria una @menzione in ogni messaggio inviato all'app negli spazi. Questo è l'unico modo per cui 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 ai il messaggio dell'utente. Ad esempio, visualizzare l'anteprima di un link a un deal 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.

  • (Opzione consigliata) Per consentire agli amministratori di Workspace di installare la tua app per conto degli utenti della loro organizzazione, l'app deve poter 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 manipolando direttamente l'HTML di Drive.
  • Se la tua app utilizza ambiti sensibili o con restrizioni, deve essere sottoposta Verifica OAuth. Consulta l'articolo Come richiedere la verifica.
  • Se la tua app utilizza ambiti con restrizioni, deve anche passare attraverso una e la 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 per scegliere una cartella oppure di creare e riutilizzare una cartella specifica per l'app. I dati di configurazione possono in una cartella Dati app. L'app non scarica i file cartella Il mio Drive dell'utente.
  • L'app archivia solo i file su Drive collegati al funzionalità documentate dell'app.
Componente aggiuntivo Editor Funzionalità
  • Le azioni previste e obbligatorie sono incluse nel componente aggiuntivo e fornisce tutti gli strumenti necessari per completare il flusso di lavoro. Ad esempio:
    • Se il componente aggiuntivo applica lo stile all'intero documento, offre l'opzione per applicare lo stile solo al testo selezionato.
    • Se il componente aggiuntivo carica i dati di un foglio di lavoro in un feed di servizi web, include un link a quel feed per facilitare la navigazione.
    • Se il componente aggiuntivo richiede che l'utente disponga di un account, fornisce link o informazioni per creare facilmente un account se l'utente non ne ha già uno.
  • Il componente aggiuntivo contiene voci di menu nella scheda Componenti aggiuntivi.
  • Anche se il componente aggiuntivo è solo funzioni personalizzate, include della documentazione.
  • 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 creato un file diverso. aperto. Vedi Autorizzazione dei componenti aggiuntivi Editor.
  • Le modalità di autorizzazione sono impostate correttamente. Consulta Modalità di autorizzazione.
  • Il componente aggiuntivo deve essere implementato nel Runtime V8. Per ulteriori informazioni, vedi Panoramica del runtime V8.
Componente aggiuntivo Editor Esperienza utente
  • Il componente aggiuntivo fornisce tutte le informazioni necessarie per avere una la comprensione del prodotto e il suo utilizzo.
  • Il codice del componente aggiuntivo non utilizza eccessivamente le librerie, delle librerie possono causare la 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 avviso JavaScript o sulla barra rossa predefinita. Comunicano risolvere il problema e descrivere cosa deve fare l'utente per risolverlo in lingua.
    • Se possibile, se l'utente fa qualcosa di sbagliato, viene visualizzato un pulsante che consente di risolvere il problema.
    • Per ulteriori informazioni, consulta 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. Termini tecnici e gergo.
    • 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 le guida di stile dell'interfaccia utente per i componenti aggiuntivi dell'editor e utilizza la 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 avere 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 300 p, quindi non una barra di scorrimento orizzontale.
  • Il componente aggiuntivo richiede la conferma o mostra avvisi per tutti per azioni sensibili. Ad esempio, se il componente aggiuntivo sta per sovrascrivere tutti i contenuti del foglio di lavoro, l'utente viene avvisato 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 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 azioni più volte durante lo svolgimento di un'azione Caricamento in corso. Ad esempio, i pulsanti vengono disattivati o nascosti mentre è in corso il caricamento dell'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 il nome fornito nella scheda dell'app.
  • Se il componente aggiuntivo utilizza calendar.conferenceSolution, il Il nome della soluzione per videoconferenze non contiene "Google Calendar".
  • (Consigliato) Se il componente aggiuntivo utilizza calendar.conferenceSolution, la soluzione per conferenze non superi i 30 caratteri.
Componente aggiuntivo di Google Workspace Funzionalità
  • Il componente aggiuntivo utilizza il widget per la funzionalità desiderata. Ad esempio, utilizza un per selezionare un valore booleano.

Componenti aggiuntivi di Calendar

  • I calendari secondari e le deleghe sono supportati oppure no supportate, gestite in modo controllato. Ad esempio, creazione di conferenze non genera un errore se l'utente seleziona un altro calendario a cui ha accesso in modifica quando la creazione di un evento.
  • Gli eventi ricorrenti funzionano correttamente.
  • Se il componente aggiuntivo utilizza calendar.conferenceSolution, al sia fornita almeno una soluzione per conferenze.
  • Se il componente aggiuntivo fornisce soluzioni per conferenze, vengono utilizzati i campi dei dati delle conferenze. Ad esempio, videoconferenze link, numeri di telefono, link SIP, codici di accesso e altre funzionalità supportate utilizzano campi di dati strutturati e non sono forniti nel Note.
  • Se il componente aggiuntivo fornisce soluzioni per conferenze, modifica solo dettagli della conferenza e nessun altro campo dell'evento.
  • Se il componente aggiuntivo fornisce soluzioni per conferenze, la creazione 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/ sta 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 convertito, viene applicata una home page predefinita.
  • La scheda del componente aggiuntivo funziona correttamente. Ad esempio, Non sono carte duplicate. i pulsanti Indietro, Aggiorna e Aggiorna funzionano di conseguenza.
  • Dopo che l'utente autorizza il componente aggiuntivo, viene visualizzato un scheda della home page per dare il benvenuto all'utente con un pulsante di accesso (se necessario), il logo e una breve descrizione del componente aggiuntivo.
    • Se il pulsante di accesso viene attivato, presenta una pagina di accesso personalizzata del fornitore indica la presenza di un servizio di terze parti al di fuori del 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, quindi non una barra di scorrimento orizzontale.
  • Il codice del componente aggiuntivo non utilizza eccessivamente le librerie, delle librerie possono causare la perdita di prestazioni del componente aggiuntivo.

Componenti aggiuntivi di Calendar

  • Se il componente aggiuntivo fornisce soluzioni per conferenze, create siano valide e visualizzate correttamente sulla terza parte sito web 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, visualizzare l'anteprima di un link a un deal di vendita aggiunge informazioni come account, importo e fase.
  • Lo sviluppatore è affiliato al dominio visualizzato in anteprima.

Per ulteriori informazioni, vedi Visualizzare l'anteprima dei link con smart chip.

Componenti aggiuntivi per Drive

  • Se l'app archivia i file su Drive, consente agli utenti per scegliere una cartella oppure di creare e riutilizzare una cartella specifica per l'app. I dati di configurazione possono in una cartella Dati app. L'app non scarica i file cartella Il mio Drive dell'utente.
  • Il componente aggiuntivo archivia in Drive solo file che sono collegato alla funzionalità documentata del componente aggiuntivo.

Componenti aggiuntivi di Gmail

  • Il componente aggiuntivo non menziona o non rimanda al browser Chrome senza una giustificazione.
  • Il menu Altre azioni contiene azioni universali che funzionano correttamente. Ad esempio, Firma informazioni, Assistenza ecc.
Componente aggiuntivo di Google Workspace Elementi grafici

Componenti aggiuntivi di Calendar

  • Il logo della soluzione per videoconferenze è un URL pubblico. Consulta Fornisci i loghi delle soluzioni per conferenze.
  • Se il componente aggiuntivo utilizza calendar.conferenceSolution, il della soluzione per conferenze segue Requisiti di calendar.logoUrl. Consulta Risorsa manifest di Calendar.
  • Se il componente aggiuntivo utilizza calendar.logoUrl o common.logoUrl, il logo è identico all'icona forniti 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 Ambito drive.addons.metadata.readonly.
App web Funzionalità
  • L'URL di navigazione universale rimanda a un'app web. Un semplice una pagina web senza funzionalità non è considerata un'app web.