Configura la tua app nell'SDK di Google Workspace Marketplace

Questa pagina spiega come utilizzare l'SDK di Google Workspace Marketplace per configurare e gestire la tua app su Google Workspace Marketplace.

Per rendere disponibile la tua app, devi configurarla nell'SDK Marketplace. L'SDK di Marketplace è un toolkit che ti consente di creare e controllare la tua app su Marketplace. Utilizzi l'SDK Marketplace per gestire le impostazioni di Marketplace, ad esempio:

• Se la tua app è disponibile per un'organizzazione Google Workspace specifica (un'app privata) o per tutti gli utenti di Marketplace (un'app pubblica)
• I tipi di utenti del Marketplace che possono installare la tua app
• Con quali applicazioni Google Workspace si integra la tua app
• Gli ambiti OAuth richiesti dalla tua app
• Informazioni su chi ha creato e gestisce l'app

Indipendentemente dal fatto che tu pubblichi la tua app in privato o pubblicamente, devi utilizzare l'SDK Marketplace per gestire la tua app su Marketplace.

Attivare l'SDK di Marketplace

Se non l'hai ancora fatto, nel tuo progetto Google Cloud attiva l' SDK Marketplace.

Apri il progetto Cloud nella console Google Cloud.

Se non è già aperto, apri il progetto Cloud che intendi utilizzare per questo esempio:

1. Nella console Google Cloud, vai alla pagina Seleziona un progetto.

   Seleziona un progetto Cloud

2. Seleziona il progetto Google Cloud che vuoi utilizzare. In alternativa, fai clic su Crea progetto e segui le istruzioni sullo schermo. Se crei un progetto Google Cloud, potresti dover attivare la fatturazione per il progetto.

Attivare l'SDK di Marketplace

Prima di utilizzare le API di Google, devi attivarle in un progetto Google Cloud. Puoi attivare una o più API in un singolo progetto Google Cloud.

• Nella console Google Cloud, abilita l'SDK di Google Workspace Marketplace.

  Attivare l'SDK

Avviso: assicurati di attivare l'SDK di Google Workspace Marketplace, non l'API. L'API Google Workspace Marketplace è uno strumento diverso utilizzato per l'integrazione con i servizi di fatturazione e gestione delle licenze di Google.

Determinare le impostazioni di configurazione per l'app

Il seguente riferimento descrive le impostazioni disponibili nella pagina Configurazione app dell'SDK Marketplace.

Scegliere chi può visualizzare e installare la tua app

Quando configuri l'app, specifichi gli utenti che possono accedervi utilizzando le seguenti impostazioni:

• Visibilità dell'app: se pubblichi un'app all'interno di un'organizzazione Google Workspace, la scheda dell'app è non in elenco, visibile a tutti gli utenti della tua organizzazione o a chiunque utilizzi Google Workspace.
• Impostazioni di installazione: indica se l'app può essere installata solo dagli amministratori di Google Workspace.

Indipendentemente dalle impostazioni specificate nella scheda dell'app, gli utenti che appartengono a un'organizzazione Google Workspace potrebbero non essere in grado di scoprire, installare o utilizzare la tua app in base alle impostazioni configurate dagli amministratori. Gli amministratori possono influire sulla disponibilità della tua app nei seguenti modi:

• Controllare se gli utenti possono visualizzare le app sul Marketplace e installarle per loro conto.
• Utilizzare una lista consentita per gestire e selezionare le app per la propria organizzazione. Se sviluppi un'app per un'organizzazione che utilizza le liste consentite, chiedi a un amministratore di aggiungere l'app alla lista consentita.
• Disattiva alcune applicazioni Google Workspace, ad esempio rimuovendo l'accesso a Google Chat, alle app Google Chat o a entrambe. In questi casi, gli utenti non potranno installare la tua app dal Marketplace.

Per scoprire come gli amministratori gestiscono l'accesso a Marketplace, consulta la documentazione della Guida per l'amministratore di Marketplace.

Impostazioni di visibilità delle app

Avviso: una volta scelta un'opzione di visibilità e salvata la pagina Configurazione app, non potrai modificare la selezione in un secondo momento.

L'opzione Visibilità app viene visualizzata se utilizzi un account Google Workspace (un account creato dalla tua organizzazione di lavoro o scuola). Se utilizzi un account consumer (un account che termina con "@gmail.com"), puoi pubblicare solo contenuti pubblici.

• Pubblica: l'app può essere trovata e installata da persone esterne al tuo dominio. Se scegli la visibilità pubblica, Google esamina e approva la scheda dell'app prima della pubblicazione.
• Privata: solo le persone all'interno del tuo dominio possono trovare e installare la tua app.

Se scegli di pubblicare come Non in elenco, la scheda dell'app non viene visualizzata nei risultati di ricerca o di navigazione. Gli utenti possono accedere alla pagina dello store dell'app solo con l'URL diretto.

Se vuoi limitare i paesi e le regioni in cui è disponibile la tua app, devi configurare questa impostazione nella sezione Distribuzione quando crei la scheda dello Store.

Impostazioni di installazione delle app

L'opzione Impostazioni di installazione determina se gli utenti o gli amministratori di Google Workspace possono installare la tua app dalla pagina della scheda dello Store su Marketplace.

Nota :per le app Google Chat, puoi selezionare solo Installazione individuale + amministratore perché gli utenti possono scoprire e installare le app Chat direttamente da Google Chat. Per informazioni dettagliate sul funzionamento dell'installazione, vedi Come gli utenti scoprono e utilizzano le app di chat.

• Installazione individuale + amministratore (impostazione predefinita): l'app può essere installata da singoli utenti o da amministratori per il loro dominio, unità organizzativa o gruppo di utenti. I criteri di dominio di un utente potrebbero impedirgli di installare un'app anche se le installazioni individuali sono attivate.
• Installazione solo per amministratori: l'app può essere installata solo dagli amministratori per il loro dominio, la loro unità organizzativa o un gruppo di utenti. La tua app viene visualizzata solo nei risultati di ricerca del Google Workspace Marketplace per gli amministratori e le persone che non hanno eseguito l'accesso al proprio Account Google. Scegli questa opzione se la tua app richiede l'installazione del dominio.

Impostazioni comuni di installazione e visibilità

La seguente tabella riepiloga alcune delle opzioni di configurazione comuni delle app per l'installazione e la visibilità:

Utenti dell'app previsti	Impostazione Visibilità app	Impostazione Installazione di app	Chi può installare la mia app?	Chi può utilizzare la mia app?
Per le app create per un'organizzazione Google Workspace
Utenti specifici della tua organizzazione	Privato e Non in elenco	Installazione individuale + amministratore	Se consentito, chiunque nella tua organizzazione abbia l'URL della scheda dell'app.	Se consentito, chiunque nella tua organizzazione abbia l'URL della scheda dell'app.
La tua organizzazione	Privato	Installazione individuale + amministratore	Se consentito, chiunque nella tua organizzazione.	Se consentito, chiunque nella tua organizzazione.
La tua organizzazione	Privato	Solo per amministratori	Amministratori	Utenti che hanno installato l'app tramite l'amministratore.
Per le app disponibili per gli utenti esterni a un'organizzazione Google Workspace specifica
Utenti nelle organizzazioni Google Workspace	Pubblica	Solo per amministratori	Amministratori	Utenti che hanno installato l'app tramite l'amministratore.
Tutti gli utenti di Google Workspace	Pubblica	Installazione individuale + amministratore	Chiunque utilizzi le applicazioni Google Workspace per uso personale. Se consentito, gli utenti delle organizzazioni Google Workspace.	Chiunque utilizzi le applicazioni Google Workspace per uso personale. Se consentito, gli utenti delle organizzazioni Google Workspace.

Identificare in che modo l'app si integra con le applicazioni Google Workspace

Scegli i servizi Google Workspace con cui l'app o il componente aggiuntivo devono interagire, ad esempio un componente aggiuntivo di Google Workspace o un'app Google Chat. Devi scegliere almeno un'opzione. In alcuni casi, puoi includere più integrazioni di app nella scheda della tua app. Consulta Elencare insieme le integrazioni di app.

A seconda delle integrazioni delle app che scegli, potresti dover fornire ulteriori informazioni e abilitare le API pertinenti nel tuo progetto Google Cloud. La tabella seguente descrive la configurazione aggiuntiva necessaria per ciascuno:

Componente aggiuntivo di Google Workspace

Per pubblicare un componente aggiuntivo Google Workspace, devi fornire l'ID deployment del componente aggiuntivo.

Per trovare l'ID deployment in Apps Script:

1. Apri il componente aggiuntivo di Google Workspace nell'editor di Apps Script.
2. Fai clic su Esegui il deployment > Gestisci deployment.
3. Sotto l'ID deployment, fai clic su Copia.

Per trovare l'ID deployment di un componente aggiuntivo HTTP:

1. Nella pagina Configurazione app, nella sezione "Componente aggiuntivo Google Workspace", fai clic su HTTP o altri deployment > Seleziona deployment.
2. Seleziona il deployment che vuoi pubblicare.
3. Fai clic su Seleziona.

Nota:se il tuo componente aggiuntivo estende Google Chat, devi configurare anche l'API Google Chat. Per la procedura, vedi Configurare un'app di chat.

Componente aggiuntivo dell'editor (Documenti, Fogli, Presentazioni, Moduli)

Per pubblicare un componente aggiuntivo di Editor, devi fornire l'ID script progetto e la versione che vuoi pubblicare.

Per trovare l'ID script del progetto:

1. Apri il componente aggiuntivo nell'editor di Apps Script.
2. A sinistra, fai clic su Impostazioni progetto .
3. Nella sezione "ID", copia l'ID script.

Per trovare la versione, segui questi passaggi:

1. Apri il componente aggiuntivo nell'editor di Apps Script.
2. In alto a destra, fai clic su Esegui il deployment > Gestisci deployment.
3. Il numero di versione è riportato nella sezione "Configurazione".

App Google Chat

Per pubblicare un' app Google Chat interattiva, consulta la seguente documentazione:

• Se hai creato l'app di Chat come componente aggiuntivo, devi configurare le impostazioni del componente aggiuntivo nell'API Chat. Per i passaggi, vedi Configurare un'app Chat nella documentazione dei componenti aggiuntivi di Google Workspace.
• Se hai creato la tua app Chat utilizzando eventi di interazione, devi configurare le impostazioni degli eventi di interazione nell'API Chat. Per i passaggi, consulta la sezione Ricevere e rispondere agli eventi di interazione nella documentazione dell'API Chat.
• Se hai creato la tua app di chat con la configurazione automatica di AppSheet, pubblicala seguendo i passaggi descritti nella documentazione di AppSheet, Condividere l'app di chat utilizzando la configurazione automatica.

App Drive

Per pubblicare un'app Drive, devi abilitare e configurare l' API Google Drive.

App web

Per pubblicare un'app web, devi fornire il relativo URL di navigazione universale, ovvero l'URL che rimanda all'app web dal menu delle app Google . La tua web app deve essere in produzione e completamente funzionante.

Quando compili la pagina Scheda dello Store, devi fornire icone aggiuntive di dimensioni 96 x 96 e 48 x 48 pixel.

Se hai creato la tua app web in Apps Script, segui questi passaggi per ottenere l'URL di navigazione universale:

1. Apri il componente aggiuntivo di Google Workspace nell'editor di Apps Script.
2. Fai clic su Esegui il deployment > Nuovo deployment.
3. Nella sezione "Seleziona tipo", fai clic su App web.
4. Compila le opzioni e fai clic su Esegui il deployment.
5. Fai clic su Copia.

Specifica il livello di accesso richiesto dalla tua app

In Ambiti OAuth, fornisci un elenco completo degli ambiti OAuth 2.0 richiesti dalla tua app. Gli ambiti OAuth che inserisci qui devono corrispondere a quelli visualizzati nella schermata per il consenso OAuth e, se applicabile, nel file manifest di Apps Script.

Se includi più di un'integrazione di app, assicurati di aggiungere gli ambiti di ciascuna alla pagina di configurazione dell'app SDK di Marketplace e alla schermata per il consenso OAuth.

Utilizza sempre gli ambiti più ristretti possibili (ad esempio, non includere un ambito Drive completo se ti serve solo un ambito di sola lettura).

Per i progetti Apps Script, consulta Ambiti di autorizzazione per maggiori dettagli.

Fornisci informazioni sullo sviluppatore dell'app

Nella sezione Informazioni sviluppatore, compila i dati di contatto e altri dettagli. Questi campi vengono visualizzati nella pagina della scheda dello Store della tua app.

Campi
Stato commerciante	Ai sensi delle leggi per la tutela dei consumatori, i consumatori che risiedono nello Spazio economico europeo (SEE) devono essere informati se i venditori presenti nel Marketplace sono commercianti o non commercianti: Commerciante: una persona che agisce per scopi relativi a un'attività commerciale, imprenditoriale, artigianale o professionale oppure a nome o per conto di un commerciante. Non commerciante: un non commerciante (consumatore) è una persona che agisce per scopi non professionali. Se non specificato, nella pagina della scheda dello Store della tua app viene visualizzato il messaggio "Stato commerciante non specificato".
Nome sviluppatore	Il nome da visualizzare come autore dell'app. Se sei un commerciante, fornisci la tua ragione sociale o il tuo nome legale.
Indirizzo postale sviluppatore	Obbligatorio per i commercianti. Non vengono raccolti per i non commercianti. La sede della tua attività. Inserisci un indirizzo postale valido al quale poterti contattare.
URL del sito web dello sviluppatore	Il sito web che descrive te (o la tua organizzazione) come sviluppatore.
Email dello sviluppatore	L'indirizzo email da utilizzare come punto di contatto. Non è incluso nella scheda dell'app. Assicurati che questo indirizzo email sia sempre aggiornato, in quanto viene utilizzato per: Se Google deve contattare lo sviluppatore, ad esempio durante il processo di revisione dell'app. Per inviare feedback dai componenti aggiuntivi dell'editor se non viene fornito un URL Segnala problema nella pagina della scheda dello Store.
URL del sito web dell'applicazione	(Facoltativo) Il sito web che descrive ulteriormente la tua app.

Salvare le impostazioni di configurazione dell'app nell'SDK di Marketplace

Utilizzando le informazioni della sezione precedente, salva la configurazione dell'app nell'SDK di Marketplace:

1. Nella console Google Cloud, vai alla pagina Configurazione app di Marketplace SDK:

   Vai alla pagina di configurazione dell'SDK di Marketplace

2. Compila ogni sezione in base a quanto stabilito nella sezione precedente.

3. Fai clic su Salva bozza.

4. (Facoltativo) Puoi ottenere analisi sull'utilizzo dell'app in Google Analytics. Per farlo, aggiungi un ID Google Analytics nell'SDK Marketplace.

   1. Vai alla scheda Analytics.
   2. Inserisci il tuo ID Google Analytics.
   3. Fai clic su Salva.

Risoluzione dei problemi

Questa sezione descrive i problemi comuni che potresti riscontrare.

Mancano le autorizzazioni richieste per la pubblicazione di app sul Marketplace

Non puoi pubblicare app su Marketplace perché i tentativi di configurare l'applicazione nella pagina Configurazione app dell'SDK di Marketplace non vanno a buon fine e viene visualizzato il seguente messaggio di errore:

You are missing at least one of the following required permissions: Project workspacemarketplace.appconfiguration.view / workspacemarketplace.appconfiguration.update

Questo errore si verifica quando l'API Marketplace SDK è abilitata e quando si utilizza un ruolo IAM diverso da Editor o Owner.

Per risolvere l'errore, implementa una delle seguenti soluzioni:

• Chiedi al proprietario del progetto di assegnare il ruolo roles/appmetadata.workspaceMarketplaceAppConfigurationAdmin all'account con le autorizzazioni mancanti per consentirgli di configurare e gestire l'app nell'SDK di Marketplace.

• Chiedi al proprietario del progetto di aggiungere le autorizzazioni mancanti a un ruolo personalizzato tramite la pagina IAM e amministrazione > Ruoli nella console Google Cloud. Quindi, assegna il ruolo personalizzato all'account con le autorizzazioni mancanti.

• roles/editor o roles/owner possono essere utilizzati per la pubblicazione di app. Tuttavia, la documentazione Utilizzare IAM in modo sicuro considera questa pratica errata in quanto non è possibile limitare facilmente l'accesso in modifica ad altre risorse del progetto.