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 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 del Marketplace che possono installare la tua app
• Le applicazioni 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.

Attivare 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 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

La seguente documentazione di riferimento descrive le impostazioni disponibili nella pagina App Configuration (Configurazione app) dell'SDK di Marketplace.

Scegliere chi può visualizzare e installare l'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, 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 trovare, installare o utilizzare la tua app in base alle impostazioni impostate 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 dell'app prima della pubblicazione.
• 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 le installazioni dei singoli utenti sono abilitate.
• Installazione solo per gli 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 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 seguente tabella riassume alcune delle opzioni di configurazione comuni delle app per l'installazione e la visibilità:

Utenti previsti dell'app	Impostazione Visibilità 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 che 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 della tua 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ù limitati 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 della scheda dello Store della tua 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, imprenditoriale, artigianale o professionale oppure per conto o a nome 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 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 commercianti. Non raccolti per i non commercianti. La sede della tua attività. Inserisci un indirizzo postale valido al quale poterti contattare.
URL del sito web 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 poiché viene utilizzato: Se Google deve contattare lo sviluppatore, ad esempio durante la procedura di revisione dell'app. Per inviare un feedback dai componenti aggiuntivi di Editor se non è fornito un URL per segnalare 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 quanto 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.