Procedura di revisione delle app e requisiti per Google Workspace Marketplace

• 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.

• 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 Eseguire la creazione di una home page per un'app Google Chat.
• L'app supporta il comando "Guida" e aiuta gli utenti a iniziare a utilizzare l'app. Per ulteriori informazioni, consulta rispondere ai comandi con barra.
• L'app risponde sempre quando le viene rivolto il discorso in uno spazio o in una chat diretta.
• 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.
• Il formato delle schede utilizzato dall'app soddisfa i requisiti di Google. Consulta Crea schede interattive.
• 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.
• È necessaria una @menzione in ogni messaggio inviato all'app negli spazi. È l'unico modo in 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 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 Anteprime dei link.

• (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.

• L'app ha un avatar riconoscibile e chiaro.

• 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 l'articolo Come richiedere la verifica.
• Se la tua app utilizza ambiti con restrizioni, deve anche superare una valutazione della sicurezza. Consulta Perché è necessaria la valutazione della sicurezza.

• 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.
• L'app archivia in Drive solo i file collegati alla funzionalità documentata dell'app.

• 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 gli stili all'intero documento, offre la possibilità di applicarli 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 semplificare la 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 contiene 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 relativo 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.
• Le modalità di autorizzazione siano configurate correttamente. Vedi Modalità di autorizzazione.
• Il componente aggiuntivo deve essere implementato nel runtime V8 di Apps Script. Per maggiori informazioni, consulta la panoramica del runtime V8.

• 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, perché 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.
  • Per ulteriori informazioni, consulta la guida allo stile dei 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 comprendere. I termini tecnici e il gergo vengono evitati.
  • I flussi di lavoro sono chiari e semplificati il più possibile.
  • L'utente e i suoi contenuti sono il più al sicuro 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 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 scorrere troppo in 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 modificando il 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.

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.

• Il componente aggiuntivo utilizza i widget (o l'interfaccia utente con iframe nei componenti aggiuntivi di Meet) corretti 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 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 le conferenze, modifica solo i dettagli della conferenza e nessun altro campo dell'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 e non HTTP.
• Il dominio completo è specificato.
• Il percorso non è vuoto. Ad esempio, https://altostrat/ è corretto, mentre https://altostrat non lo è.
• I caratteri jolly non possono essere utilizzati 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 dell'attività.
• Il componente aggiuntivo non deve fornire funzionalità per invitare un bot o fare affidamento sulla presenza di un bot nella riunione

• 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.
• La scheda del componente aggiuntivo (o l'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, viene visualizzata una scheda della home page personalizzata (pagina web in 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, 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 eseguire molto scorrimento 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, poiché le librerie possono causare una perdita di prestazioni del componente aggiuntivo.

Componenti aggiuntivi di Calendar

• Se il componente aggiuntivo fornisce soluzioni per conferenze, 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 l'anteprima dei link di un dominio di terze parti (smart chip):

• Le anteprime dei link offrono all'utente informazioni supplementari 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 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 a 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 sui requisiti di licenza e abbonamento che potrebbero essere necessari per utilizzarlo. 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, nel componente aggiuntivo deve essere visualizzata la richiesta di accesso One Tap disponibile in Display Google One Tap e un elemento di riserva "Accedi con Google" disponibile nella sezione 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 degli utenti aggiuntivi devono essere funzionali anche se i cookie di terze parti sono disabilitati.
• Il componente aggiuntivo non deve avere lo 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 a 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 della localizzazione: la lingua deve essere basata sulle preferenze locali impostate dal browser, se disponibili.
• (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 dovrebbe chiudere il riquadro laterale dopo essere stato avviato nella schermata principale.

Componenti aggiuntivi di Calendar

• Il logo della soluzione per le conferenze è un URL pubblico. Consulta Fornisci i loghi delle soluzioni per le conferenze.
• 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

Componenti aggiuntivi per Drive

• (Consigliato) Se vuoi ricevere metadati limitati, il componente aggiuntivo include l'ambito drive.addons.metadata.readonly.

• L'URL di navigazione universale rimanda a un'app web. Una semplice pagina web senza funzionalità non è considerata un'app web.