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 con essa.
• 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.
• La @menzione è obbligatoria in ogni messaggio all'app negli spazi. È l'unico modo in cui l'app sa che deve rispondere.
• Se l'app Chat mostra l'anteprima dei link di un dominio di terze parti:
  • Le anteprime dei link offrono informazioni aggiuntive pertinenti al messaggio dell'utente. Ad esempio, la visualizzazione di un'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 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. Leggi l'articolo Come faccio a richiedere la verifica.
• Se la tua app utilizza ambiti con restrizioni, deve anche essere sottoposta a 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 di creare e riutilizzare 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.

• 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 applicarli solo al testo selezionato.
  • Se il componente aggiuntivo carica i dati del foglio di lavoro in un feed del servizio web, ha un link a quel 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 è costituito solo da funzioni personalizzate, include comunque la documentazione appropriata.
• Il componente aggiuntivo utilizza correttamente onInstall() e onOpen() per compilare il 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 sono configurate correttamente. Vedi Modalità di autorizzazione.
• Il componente aggiuntivo deve essere implementato nel runtime V8 di Apps Script. Per ulteriori informazioni, consulta 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, poiché 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 alle 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 eseguire molto scorrimento 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 apportando modifiche al 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 in 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 di videoconferenza, vengono utilizzati i campi di dati delle conferenze appropriati. Ad esempio, i link per le videoconferenze, i numeri di telefono, i link SIP, i codici di accesso e altri attributi supportati utilizzano i campi dei dati strutturati e non sono 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 le 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, ma https://altostrat non lo è.
• Non è possibile utilizzare i caratteri jolly 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 sono presenti 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 nei 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, 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'interfaccia utente 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 supera i 300 pixel, in modo che non sia presente 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 le 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 l'anteprima dei link di un dominio di terze parti (smart chip):

• Le anteprime dei link offrono all'utente informazioni supplementari pertinenti. Ad esempio, la visualizzazione di un link a un deal di vendita aggiunge informazioni come account, importo e fase.
• Lo sviluppatore è affiliato al dominio visualizzato in anteprima.

Per saperne di più, vedi Visualizzare l'anteprima dei link con gli smart chip.

Componenti aggiuntivi per Drive

• 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.
• Il componente aggiuntivo archivia in 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, il componente aggiuntivo deve presentare la richiesta di accesso One Tap disponibile in Mostra One Tap di Google e un'opzione di riserva "Accedi con Google" disponibile in 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 utente dei componenti aggiuntivi devono essere funzionali anche se i cookie di terze parti sono disattivati.
• Il componente aggiuntivo non deve avere 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 per 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 sulla preferenza locale impostata dal browser, se disponibile.
• (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 chiuderlo dopo il lancio nella fase 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.