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 la tua app disponibile per l'uso, devi configurarla nell'SDK di Marketplace. L'SDK Marketplace è un toolkit che ti consente di creare e controllare la tua app su Google Workspace Marketplace. Utilizza l'SDK Marketplace per gestire le impostazioni del 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 di Marketplace che possono installare la tua app
• Le applicazioni di Google Workspace con cui 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 privatamente o pubblicamente, devi utilizzare l'SDK Marketplace per gestire la tua app sul marketplace.

Abilita l'SDK Marketplace

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

Aprire 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 Google Workspace 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.

  Attiva l'SDK

Determina le impostazioni di configurazione per la tua app

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

Scegliere chi può visualizzare e installare l'app

Quando configuri la tua 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, puoi scegliere se la scheda dell'app non deve essere inclusa o se deve essere 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 dai loro amministratori. Gli amministratori possono influire sulla disponibilità della tua app nei seguenti modi:

• Controllare se i propri utenti possono visualizzare le app nel Marketplace e installare app per conto degli utenti.
• Utilizzare una lista consentita per gestire e organizzare le app per la propria organizzazione. Se stai sviluppando un'app per un'organizzazione che utilizza le liste consentite, rivolgiti a un amministratore per aggiungere l'app alla lista consentita.
• Disattivare determinate applicazioni Google Workspace, ad esempio rimuovendo l'accesso a Google Chat, alle app di Google Chat o a entrambi. In questi casi, gli utenti non potranno installare la tua app dal Marketplace.

Per scoprire come gli amministratori gestiscono l'accesso al Marketplace, consulta la documentazione Guida per gli amministratori del Marketplace.

Impostazioni di visibilità delle app

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

• 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 della tua app prima che venga pubblicata.
• Privato: solo le persone all'interno del tuo dominio possono trovare e installare la tua app.

Se scegli di pubblicare come Non elencata, 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, puoi impostare questa opzione 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 Google Workspace Marketplace.

• Installazione individuale + amministratore (predefinita): l'app può essere installata da singoli utenti o da amministratori per il proprio dominio, la propria unità organizzativa o un gruppo di utenti. I criteri del dominio di un utente potrebbero impedirgli di installare un'app anche se sono attivate le singole installazioni.
• Solo installazione amministratore: l'app può essere installata solo dagli amministratori del loro dominio, unità organizzativa o gruppo di utenti. La tua app viene visualizzata nei risultati di ricerca del Google Workspace Marketplace solo per gli amministratori e gli utenti 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 tabella seguente riassume alcune delle opzioni di configurazione comuni delle app per l'installazione e la visibilità:

Utenti previsti dell'app	Impostazione Visibilità delle app	Impostazione Installazione app	Chi può installare la mia app?	Chi può utilizzare la mia app?
Per le app create per un'organizzazione Google Workspace
Utenti specifici dell'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 che 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 amministratore	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 delle organizzazioni Google Workspace	Pubblica	Solo amministratore	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 la tua 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 dell'app. Consulta Elencare insieme le integrazioni di app.

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

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 inseriti 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 dell'SDK 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 App Script, consulta Ambiti di autorizzazione per ulteriori dettagli.

Fornire informazioni sullo sviluppatore dell'app

In Informazioni sviluppatore, compila i dati di contatto e altri dettagli. Questi campi vengono visualizzati nella pagina Scheda dello Store dell'app.

Campi
Stato commerciante	Ai sensi delle leggi sulla tutela dei consumatori, i consumatori che risiedono nello Spazio economico europeo (SEE) devono essere informati se un commerciante su Google Workspace Marketplace è un commerciante o un non commerciante: Commerciante: un commerciante è una persona che agisce per scopi relativi a un'attività commerciale, aziendale, artigianale o professionale oppure in 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 dell'app viene visualizzato lo stato"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 dello sviluppatore	Obbligatorio per i trader. Dati non 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 ti descrive (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 man mano che viene utilizzato: Se Google deve contattare lo sviluppatore, ad esempio durante la procedura di revisione dell'app. Per inviare un feedback da Editor Add-ons se non è fornito un URL per la segnalazione di un 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 riportate nella sezione precedente, salva la configurazione dell'app nell'SDK di Marketplace:

1. Nella console Google Cloud, vai alla pagina Configurazione dell'SDK Marketplace:

   Vai alla pagina di configurazione dell'SDK di Marketplace

2. Compila ogni sezione in base a ciò che hai stabilito nella sezione precedente.

3. Fai clic su Salva.

4. (Facoltativo) Puoi ottenere dati e analisi sull'utilizzo dell'app in Google Analytics. A tale scopo, 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.