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 la tua app su Google Workspace Marketplace.

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

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

Indipendentemente dal fatto che tu stia pubblicando la tua app pubblicamente o privatamente, devi utilizzare l'SDK di Google Workspace Marketplace per gestirla su Marketplace.

Attiva l'SDK di Google Workspace Marketplace

Se non lo hai già fatto, nel tuo progetto Google Cloud abilita l'SDK di 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 progetto 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à attivato, fai clic su Attiva.

Inserire le impostazioni dell'app nell'SDK di Google Workspace Marketplace

  1. Apri l'SDK di Google Workspace Marketplace.
  2. Vai alla scheda Configurazione app.
  3. Compila ogni sezione con le informazioni sulla tua app. Per ulteriori informazioni su ciascuna impostazione, consulta la sezione Impostazioni di configurazione dell'app seguente.
  4. Fai clic su Salva.
  5. (Facoltativo) Puoi ricevere 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.

Impostazioni di configurazione app

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

Visibilità delle app

Vedi l'opzione Visibilità delle app se utilizzi un account Google Workspace (un account creato dalla tua organizzazione lavorativa o scolastica). Se utilizzi un account consumer (un account che termina con "@gmail.com"), puoi pubblicare contenuti solo pubblicamente.

  • Pubblica: l'app può essere trovata e installata da persone esterne al dominio. Se scegli la visibilità pubblica, Google esamina e approva la scheda dell'app prima che venga pubblicata.
  • Privata: 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 verrà mostrata nei risultati di navigazione o di ricerca. 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 impostarli nella sezione Distribuzione quando crei la scheda dello Store.

Impostazioni di installazione

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

  • Installazione individuale + amministratore (impostazione predefinita): l'app può essere installata da singoli utenti o dagli amministratori del loro dominio, dell'unità organizzativa o di un gruppo di utenti. I criteri del dominio di un utente potrebbero impedirgli di installare un'app anche se sono abilitate le singole installazioni.
  • Installazione solo per amministratori: l'app può essere installata solo dagli amministratori per il proprio dominio, unità organizzativa o un gruppo di utenti. La tua app viene visualizzata nei risultati di ricerca di 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 applicazione richiede l'installazione del dominio.

Integrazione app

Scegli i servizi Google Workspace con cui la tua app o il tuo componente aggiuntivo sono progettati, 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 le integrazioni delle app.

A seconda delle integrazioni di app scelte, potrebbe essere necessario fornire ulteriori informazioni e abilitare le API pertinenti nel tuo progetto Google Cloud. La seguente tabella descrive la configurazione aggiuntiva necessaria per ognuno:

Componente aggiuntivo di Google Workspace (Apps Script)

Per pubblicare un componente aggiuntivo di Google Workspace, devi fornire il relativo ID deployment. Per trovare l'ID deployment:

  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.

Componente aggiuntivo di Google Workspace (runtime alternativo)

Se hai creato il componente aggiuntivo di Google Workspace in un linguaggio di programmazione diverso da Google Apps Script, segui questi passaggi per ottenere l'ID deployment dalla risorsa di deployment di Google Cloud.

  1. Nella pagina Configurazione app, in "Componente aggiuntivo di Google Workspace", fai clic su Esegui il deployment utilizzando la risorsa di deployment cloud > Seleziona Deployment.
  2. Seleziona il deployment che vuoi pubblicare.
  3. Fai clic su Seleziona.

Componente aggiuntivo Editor (Documenti, Fogli, Presentazioni, Moduli)

Per pubblicare un componente aggiuntivo dell'editor, devi fornire l'ID e la versione dello script del progetto che vuoi pubblicare.

Per trovare l'ID dello script del progetto, segui questi passaggi:

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

Per trovare la versione, procedi nel seguente modo:

  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 della versione si trova in "Configurazione".

App Google Chat

Per pubblicare un'app Google Chat, devi configurare l'API Google Chat. Vedi Pubblicare app.

App Drive

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

App web

Per pubblicare un'app web, devi fornire il relativo URL di navigazione universale, l'URL che indirizza all'app web dal menu delle app Google . L'app web deve essere in produzione e completamente funzionale.

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

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

  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.

Ambiti OAuth

Fornisci un elenco completo degli ambiti OAuth 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ù integrazioni di app, assicurati di aggiungere gli ambiti da ciascuno alla pagina di configurazione delle app dell'SDK di Google Workspace Marketplace e alla schermata per il consenso OAuth.

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

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

Informazioni sugli sviluppatori

Questi campi vengono visualizzati nella pagina scheda dello Store dell'app.

Campi
Stato commerciante

Ai sensi delle leggi per la tutela dei consumatori, i consumatori che risiedono nello Spazio economico europeo (SEE) devono sapere 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, un'attività, un mestiere o una professione oppure in nome o per conto di un commerciante.
  • Non commerciante: non commerciante (consumatore) si intende una persona che agisce per scopi non professionali.

Se il valore non è specificato, nella pagina della scheda dello Store dell'app viene visualizzato lo"Stato del commerciante non specificato".

Indirizzo postale dello sviluppatore

Obbligatorio per i trader. Non raccolti per i non commercianti.

La località in cui ha sede la tua attività commerciale. Inserisci un indirizzo postale valido a cui poterti contattare.

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

  • Se Google deve contattare lo sviluppatore, ad esempio durante la procedura di revisione dell'app.
  • Per inviare feedback dai componenti aggiuntivi di Editor se nella pagina della scheda dello Store non viene fornito l'URL della segnalazione del problema.
URL del sito web dell'applicazione Facoltativo. Il sito web che descrive ulteriormente la tua app.