Dopo aver creato un'app di chat, puoi pubblicarla in modo che sia disponibile per utenti o gruppi selezionati, per tutti gli utenti della tua organizzazione Google Workspace o per qualsiasi utente di Google Chat.
In che modo gli utenti scoprono e utilizzano le app Google Chat
Per trovare le app Google Chat, gli utenti possono:
- Cercare e installare app da Google Chat.
- Interagire con un'app che è stata aggiunta a uno spazio di Chat.
- Trovare l'app nel riquadro dei messaggi diretti, dopo che un amministratore di Google Workspace l'ha installata per suo conto.
Per iniziare a utilizzare un'app, gli utenti di Google Chat possono iniziare un messaggio diretto con l'app o aggiungerla a uno spazio. Gli utenti possono aggiungere l'app anche @ menzionandola. L'esempio seguente mostra in che modo un utente @ menziona un'app di Chat per aggiungerla a uno spazio:
In alternativa, gli amministratori di Google Workspace possono trovare le app di Chat in Google Workspace Marketplace e installarle per gli utenti della loro organizzazione. Quando gli amministratori installano un'app di chat, l'app viene visualizzata nel riquadro dei messaggi diretti degli utenti.
Gli amministratori di Google Workspace possono anche gestire e autorizzare l'utilizzo delle app di Chat nella propria organizzazione Google Workspace. Se stai sviluppando un'app Chat per un'organizzazione che utilizza le liste consentite, devi richiedere a un amministratore di aggiungere l'app Chat alla lista consentita in modo che gli utenti possano trovarla e utilizzarla. Per saperne di più, consulta la documentazione della Guida per gli amministratori di Google Workspace, Consentire agli utenti di installare app di Chat.
Configura e pubblica la tua app di chat utilizzando la console Google Cloud
Per pubblicare la tua app di chat e renderla disponibile ad altri, in genere devi seguire questi passaggi:
- Attivare e configurare l'API Google Chat Quando configuri l'API, concedi ad altri utenti di Google Chat l'accesso alla tua app Chat per il test.
- Pubblica l'app con l'SDK di Google Workspace Marketplace. Puoi configurare l'app di chat in modo che sia disponibile per gli utenti della tua organizzazione Google Workspace o per tutti gli utenti di Google Chat.
- Se la tua organizzazione Google Workspace gestisce l'accesso alle app di Chat, chiedi all'amministratore di Google Workspace di aggiungere l'app alla lista consentita dell'organizzazione.
Impostazioni di visibilità e pubblicazione per l'app Chat
La tabella seguente spiega come configurare le impostazioni per l'API Google Chat e l'SDK Google Workspace Marketplace in base al pubblico della tua app Chat:
| Utenti di app desiderati | Metodo di autenticazione | Impostazioni API Google Chat | Impostazioni dell'SDK di Google Workspace Marketplace | Dove è pubblicata la mia app di chat? |
|---|---|---|---|---|
| Il tuo piccolo team | Autenticati come utente o app. | Nell'impostazione Visibilità, specifica le persone o i gruppi Google che
possono accedere all'app.
Se il tuo account Google Workspace richiede che le app siano inserite nella lista consentita, puoi specificare solo fino a 5 indirizzi email individuali (non puoi specificare Google Gruppi). |
Non è necessario configurare l'SDK di Google Workspace Marketplace per l'app di chat. | I membri del team possono trovare e utilizzare la tua app di chat da Google Chat. |
| Il tuo team numeroso | Autenticati come utente o app. | Nell'impostazione Visibilità, specifica le persone o i gruppi Google che dovranno testare l'app di Chat.
Dopo il test, pubblica l'app di chat nella tua organizzazione Google Workspace utilizzando le impostazioni dell'SDK di Google Workspace Marketplace. |
Imposta Visibilità app su Privata. Configura le Impostazioni di installazione su Privato + Amministratore. Se il tuo account Google Workspace richiede l'inserimento delle app nella lista consentita, chiedi a un amministratore di aggiungere la tua app di chat alla lista consentita, in modo che gli utenti possano trovarla e utilizzarla. Per saperne di più, consulta la documentazione della Guida per gli amministratori di Google Workspace, Consentire agli utenti di installare app di Chat. |
Chiunque nella tua organizzazione Google Workspace può trovare e installare la tua app di chat in Google Chat e visualizzarla in Google Workspace Marketplace. Gli utenti e gli amministratori di Google Workspace possono installare la tua app dal Marketplace. |
| La tua organizzazione Google Workspace | Autenticati come utente o app. | Nell'impostazione Visibilità, specifica le persone o i gruppi Google che
testare l'app di chat.
Dopo il test, pubblica l'app di chat nella tua organizzazione Google Workspace utilizzando le impostazioni dell'SDK di Google Workspace Marketplace. |
Imposta Visibilità app su Privata. Configura le Impostazioni di installazione su Privato + Amministratore. |
Chiunque nella tua organizzazione Google Workspace può trovare e installare la tua app di chat in Google Chat e visualizzarla in Google Workspace Marketplace. Solo gli amministratori di Google Workspace possono installare la tua app dal Marketplace. |
| Tutti (app di Chat pubblica) | Autenticati come utente o app. | Nell'impostazione Visibilità, specifica le persone o i gruppi Google che
testare l'app di chat.
Dopo il test, pubblica pubblicamente l'app di chat utilizzando le impostazioni in Google Workspace Marketplace. |
Imposta Visibilità app su Pubblico. Configura le Impostazioni di installazione su Privato + Amministratore |
Qualsiasi utente di Google Workspace può trovare e installare la tua app di chat in Google Chat e visualizzarla in Google Workspace Marketplace. Solo gli amministratori di Google Workspace possono installare la tua app dal Marketplace. |
Attivare e configurare l'API Google Chat
Configura un progetto per la tua app nella console Google Cloud e abilita l'API Google Chat:
- Utilizza il pulsante in basso per creare un nuovo progetto (o selezionarne uno esistente) e aggiungere un account di servizio. Concedere all'account di servizio il ruolo Proprietario progetto.
Abilita l'API - Salva la chiave JSON scaricata. L'app può usare questa chiave per autenticare i messaggi che invia agli spazi in modo asincrono.
- Apri il progetto nella . Nell'elenco delle API, fai clic su API Google Chat.
- Seleziona la scheda Configuration (Configurazione) e inserisci le informazioni relative all'app, come descritto nella tabella seguente.
Quando salvi la configurazione dell'app, l'app diventa disponibile per gli utenti specificati nella tua organizzazione Google Workspace.
Impostazioni di configurazione dell'API Google Chat
| Campo | Descrizione |
|---|---|
| Nome dell'app | Il nome che le persone utilizzano quando interagiscono con la tua app di chat. |
| URL avatar | Un URL HTTPS che rimanda a un'immagine grafica quadrata (ad es. PNG o JPEG), di almeno 128 x 128, che verrà visualizzata come avatar per la tua app di chat. |
| Descrizione | Una descrizione della funzionalità dell'app di chat visualizzata sotto il nome dell'app. |
| Funzionalità | Una serie di campi che determinano in che modo l'app di chat può interagire con gli utenti:
|
| Impostazioni di connessione | L'endpoint per l'app Chat, che è uno dei seguenti:
|
| Comandi slash | Comandi che possono essere mostrati agli utenti in Google Chat. Consente agli utenti di visualizzare le azioni principali della tua app di chat in Google Chat e di scegliere un'azione specifica con cui interagire. |
| Anteprime link | Pattern URL che l'app di chat riconosce e fornisce contenuti aggiuntivi per i quali gli utenti inviano link. Per saperne di più, consulta Link alle anteprime. |
| Visibilità | Fino a 5 persone o uno o più gruppi Google in grado di visualizzare e installare la tua app di chat. Utilizza questo campo per testare l'app Chat o per condividerla con il tuo team. Per saperne di più, vedi Impostazioni di visibilità e pubblicazione per l'app Chat. |
Concedere le autorizzazioni per la configurazione delle app
Puoi concedere a utenti specifici l'accesso alla pagina di configurazione dell'app. A questo scopo, utilizza i ruoli IAM Proprietario app di chat e Visualizzatore app di chat. Gli utenti con questi ruoli non possono accedere alla pagina di configurazione dell'app tramite la dashboard API e servizi, ma possono accedere alla pagina di configurazione accedendo alla console del progetto nel seguente modo:
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID
Pubblicare l'app con l'SDK di Google Workspace Marketplace
Utilizza l'SDK di Google Workspace Marketplace per:
- Pubblica la tua app pubblicamente e consenti a qualsiasi utente di Google Chat di aggiungerla a uno spazio.
- Pubblica l'app nel tuo dominio.
- Rendi visibile la tua app agli amministratori di Google Workspace in modo che possano installarla per gli utenti della loro organizzazione. Per essere visibile agli amministratori di Google Workspace, la tua app deve includere i messaggi diretti.
Prima di pubblicare la tua app utilizzando l'SDK di Google Workspace Marketplace, segui questi passaggi:
- Testa la tua app di Chat installandola da Chat. Assicurati che la tua app sia completamente funzionale e che non sia in fase di sviluppo.
- Esamina i requisiti di pubblicazione e verifica che la tua app li soddisfi tutti. Vedi Aree di revisione.
- Registra il numero di versione dell'app: è necessario per configurare l'SDK di Google Workspace Marketplace.
Quando tutto è pronto per la pubblicazione, consulta l'articolo Panoramica: pubblicare un'app.
Disattivare l'app Chat
Dopo aver salvato la pagina di configurazione, viene visualizzato il campo Stato app. Questo campo consente di stabilire se l'app deve essere impostata su Attivata o Disattivata.
Per disattivare un'app di chat:
- Apri la console Google Cloud.
- Se necessario, seleziona il progetto Google Cloud che ospita l'app Chat:
- Accanto a "Google Cloud", fai clic sulla Freccia giù . Viene visualizzata una finestra di dialogo che elenca i progetti attuali.
- Seleziona il progetto che ospita l'app Chat di cui è stata eseguita la migrazione.
- Fai clic su Apri.
- Cerca "API Google Chat" e fai clic su API Google Chat.
- Fai clic su Gestisci.
- Fai clic su Configurazione.
- Nella sezione "Stato app", seleziona Disattivata.
- Fai clic su Salva.