Configura la tua app nell'SDK di Google Workspace Marketplace

In questa pagina viene spiegato come utilizzare l'SDK di Google Workspace Marketplace per configurare e gestire su Google Workspace Marketplace.

Per rendere la tua app disponibile per l'uso, devi configurarla nell'SDK di Google Workspace Marketplace. L'SDK di Google Workspace Marketplace è un toolkit che ti consente di creare e controllare su Google Workspace Marketplace. Puoi utilizzare l'SDK di Google Workspace Marketplace per gestire Impostazioni di Marketplace, come le seguenti:

• Se la tua app è disponibile per un'organizzazione Google Workspace specifica (un'app privata) o per tutti gli utenti del Marketplace (una app pubblica)
• I tipi di utenti di Marketplace che possono installare 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

A prescindere dal fatto che pubblichi pubblica o privatamente la tua app, devi utilizzare l'SDK di Google Workspace Marketplace per gestire sul Marketplace.

Abilita l'SDK di Google Workspace Marketplace

Se non l'hai ancora fatto, nel tuo progetto Google Cloud: Attiva l'SDK Google Workspace Marketplace:

1. Apri la console Google Cloud.
2. In alto, fai clic su Seleziona un progetto. Se un altro progetto Google Cloud già aperto, fai clic sul nome del progetto Cloud per cambiare di Google Cloud per i progetti cloud.
3. Seleziona il progetto cloud dell'app e fai clic su Apri.
4. In alto, nella barra di ricerca, digita Google Workspace Marketplace SDK e premi Invio.

5. Apri la pagina dell'SDK di Google Workspace Marketplace.

6. Se l'SDK di Google Workspace Marketplace non è già abilitato, fai clic su Abilita.

Determina le impostazioni di configurazione dell'app

Di seguito vengono descritte le impostazioni disponibili nell'App pagina di configurazione dell'SDK Google Workspace Marketplace.

Scegli chi può visualizzare e installare la tua app

Quando configuri la tua app, specifichi gli utenti che possono accedervi utilizzando le seguenti impostazioni:

• Visibilità delle app. Se pubblichi un'app all'interno di una a un'organizzazione Google Workspace, se 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ò solo essere installati dagli amministratori di Google Workspace.

Indipendentemente dalle impostazioni specificate nella scheda dell'app, gli utenti appartenenti un'organizzazione Google Workspace potrebbe non essere in grado di rilevare, installare o usare la tua app in base alle impostazioni configurate dagli amministratori. Amministratori possono influire sulla disponibilità della tua app nei seguenti modi:

• Controllare se i loro utenti possono visualizzare le app nel Marketplace e installare app per conto dei propri utenti.
• Utilizza 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, a un amministratore per aggiungere l'app alla lista consentita.
• Disattivare alcune applicazioni di Google Workspace, ad esempio la rimozione l'accesso a Google Chat, alle app Google Chat o a entrambe. In questi casi, Gli utenti non potranno installare la tua app Marketplace.

Per scoprire come gli amministratori gestiscono l'accesso a di Google, consulta Documentazione di assistenza per amministratori di Marketplace

Impostazioni di visibilità delle app

Se utilizzi una versione di Google Workspace, vedrai l'opzione Visibilità delle app. account (un account creato dalla tua organizzazione scolastica o lavorativa). Se utilizzando un account consumer (un account che termina con "@gmail.com"), puoi sono disponibili pubblicamente.

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

Se scegli di pubblicare l'app come Non in elenco, la scheda dell'app non apparirà nella sezione Sfoglia. o nei risultati di ricerca. Gli utenti possono accedere alla pagina dello store dell'app solo con la richiesta URL.

Se vuoi limitare i paesi e le regioni in cui è disponibile la tua app, puoi configurarlo nella sezione Distribuzione quando crea la scheda dello Store.

Impostazioni di installazione delle app

Le impostazioni di installazione determinano se gli utenti o gli amministratori di Workspace possono installare l'app l'app dalla pagina della scheda dello Store su Google Workspace Marketplace.

• Installazione individuale + amministratore (impostazione predefinita): l'app può essere installata tramite singoli utenti o amministratori per il dominio, l'unità organizzativa o un un gruppo di utenti specifico. I criteri del dominio di un utente potrebbero impedirne l'installazione anche se sono attivate singole installazioni.
• Solo installazione amministratore: l'app può essere installata solo dagli amministratori per il proprio un dominio, un'unità organizzativa o un gruppo di utenti. La tua app viene visualizzata soltanto in Risultati di ricerca di Google Workspace Marketplace 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 nel dominio.

Impostazioni comuni di installazione e visibilità

La seguente tabella riassume alcune delle opzioni di configurazione dell'app più comuni per installazione e visibilità:

Utenti di app auspicati	Impostazione Visibilità delle app	Impostazione per l'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 amministratore	Amministratori	Utenti che hanno installato l'app dall'amministratore.
Per le app disponibili per gli utenti esterni a una specifica organizzazione Google Workspace
Utenti delle organizzazioni Google Workspace	Pubblica	Solo amministratore	Amministratori	Utenti che hanno installato l'app dall'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 di Google Workspace

Scegli i servizi Google Workspace per cui è progettato l'app o il componente aggiuntivo lavorare con te, come un componente aggiuntivo di Google Workspace o un App Google Chat. Devi scegliere almeno un'opzione. In alcuni casi, puoi includere più integrazioni nella tua scheda. Consulta Elencare insieme le integrazioni delle app.

A seconda delle integrazioni di app che scegli, potresti dover fornire altri e abilitare le API pertinenti nel tuo progetto Google Cloud. Le seguenti la configurazione aggiuntiva richiesta per ciascuno:

Specifica il livello di accesso richiesto dalla tua app

In Ambiti OAuth, fornisci un elenco completo degli ambiti OAuth della tua app. richiede. Gli ambiti OAuth che inserisci qui devono corrispondere a ciò che visualizzi nella Schermata per il consenso OAuth e, se applicabile, manifest di Apps Script.

Se includi più integrazioni di app, assicurati di aggiungere gli ambiti da alla pagina di configurazione delle app dell'SDK di Google Workspace Marketplace e al tuo consenso OAuth schermo.

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

Per i progetti Apps Script, vedi Ambiti per ulteriori dettagli.

Fornire informazioni sullo sviluppatore di app

In Informazioni sviluppatore, inserisci i dati di contatto e altri dettagli. Questi campi vengono visualizzati nella scheda dello Store.

Campi
Stato commerciante	Ai sensi delle leggi per la tutela dei consumatori, i consumatori residenti in Europa Nello Spazio economico europeo (SEE) deve essere comunicato se un commerciante nel Google Workspace Marketplace è un commerciante o non commerciante: Commerciante: un commerciante è una persona che agisce per scopi relativi a a un'attività commerciale, artigianale o professionale; o in nome o su per conto di un commerciante. Non commerciante: un non commerciante (consumatore) è una persona che agisce per scopi non professionali. Se non specificato, "Stato commerciante non specificato" viene visualizzato nella scheda dello Store .
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 è contattabile.
Nome sviluppatore	Il nome da visualizzare come autore dell'app. Se sei un commerciante, Fornisci la tua ragione sociale o il tuo nome legale.
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 incluse nella scheda dell'app. Assicurati che questo indirizzo email sia aggiornato al data; utilizza: Se Google deve contattare lo sviluppatore, ad esempio durante la procedura di revisione delle app. Per inviare feedback dai componenti aggiuntivi di Editor se l'URL Segnala problema non è presente fornita nella pagina della scheda dello Store.
URL del sito web dell'applicazione	(Facoltativo) Il sito web che descrive ulteriormente la tua app.

Salva le impostazioni di configurazione dell'app nell'SDK di Google Workspace Marketplace

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

1. Apri l'SDK Google Workspace Marketplace.
2. Vai alla scheda Configurazione app.
3. Compila ogni sezione in base a ciò che hai stabilito nella sezione precedente.
4. Fai clic su Salva.
5. (Facoltativo) Puoi ottenere dati e analisi sull'utilizzo delle app in Google Analytics. Per farlo, aggiungi un ID Google Analytics nell'SDK di Google Workspace Marketplace.
   1. Vai alla scheda Analytics.
   2. Inserisci il tuo ID Google Analytics.
   3. Fai clic su Salva.