Se unisci organizzazioni Google Workspace, potresti dover eseguire la migrazione della tua app Chat in modo che continui a funzionare.
Prima di eseguire la migrazione dell'app Chat, contatta l'amministratore della tua organizzazione per verificare se le impostazioni amministrative la interessano. La modifica di un'impostazione amministrativa potrebbe ripristinare la funzionalità completa dell'app Chat e rendere non necessaria la migrazione. Ad esempio, l'amministratore di Google Workspace potrebbe dover aggiungere la tua app di Chat a una lista consentita o consentire agli utenti di installare app di Chat. Per maggiori informazioni, consulta Stabilire se è necessario eseguire la migrazione delle app di Google Chat dopo l'unione delle organizzazioni Google Workspace.
Dopo aver stabilito che devi eseguire la migrazione dell'app Chat, completa i seguenti tre passaggi:
- Configura l'ambiente per l'app di Chat creando un progetto Google Cloud nell'organizzazione unita, abilitando le API e configurando potenzialmente la schermata per il consenso OAuth 2.0.
- Esegui di nuovo il deployment dell'app Chat dal nuovo progetto Cloud.
- Aggiungi l'app Chat ricreata agli spazi o alle conversazioni di Chat e disattiva l'app Chat originale.
Creare un progetto Cloud nell'organizzazione unita e abilitare le API
La creazione di un nuovo progetto Cloud e l'abilitazione delle API per l'app Chat nell'organizzazione Google Workspace unita assicura che gli utenti e i gruppi a cui consenti l'accesso all'app Chat possano farlo senza errori.
Creazione di un progetto cloud
Console Google Cloud
- Nella console Google Cloud, vai a Menu > IAM e amministrazione > Crea un progetto.
-
Nel campo Nome progetto, inserisci un nome descrittivo per il progetto.
(Facoltativo) Per modificare l'ID progetto, fai clic su Modifica. L'ID progetto non può essere modificato dopo la creazione del progetto, quindi scegli un ID che soddisfi le tue esigenze per tutta la durata del progetto.
- Nel campo Località, fai clic su Sfoglia per visualizzare le potenziali località per il tuo progetto. Poi, fai clic su Seleziona.
- Fai clic su Crea. La console Google Cloud accede alla pagina Dashboard e il tuo progetto viene creato in pochi minuti.
Interfaccia a riga di comando gcloud
In uno dei seguenti ambienti di sviluppo, accedi a Google Cloud CLI ("gcloud"):
-
Cloud Shell: per utilizzare un terminale online con gcloud CLI già configurato, attiva Cloud Shell.
Attivare Cloud Shell -
shell locale: per utilizzare un ambiente di sviluppo locale, installa e initialize gcloud CLI.
Per creare un progetto Cloud, utilizza il comando "gcloud projects create":
Sostituisci PROJECT_ID impostando l'ID per il progetto che vuoi creare.gcloud projects create PROJECT_ID
Abilita le API
Tutte le app di Chat devono avere l'API Google Chat abilitata. A seconda di come è stata creata l'app Chat, potrebbe essere necessario abilitare altre API. Ad esempio, se hai creato l'app Chat utilizzando Google Cloud Functions, abilita l'API Cloud Build, l'API Cloud Functions, l'API Pub/Sub, l'API Cloud Logging, l'API Artifact Registry e l'API Cloud Run. Come best practice, per assicurarti che l'app di cui è stata eseguita la migrazione funzioni, abilita nel nuovo progetto Cloud le stesse API abilitate nel precedente progetto Cloud.
Per abilitare un'API:
Console Google Cloud
- Nella console Google Cloud, vai a Menu > Altri prodotti > Google Workspace > Libreria di prodotti.
- Fai clic sull'API che vuoi attivare.
- Fai clic su Abilita.
- Ripeti questi passaggi per attivare altre API.
Google Cloud CLI
- Installa o apri l'interfaccia a riga di comando (CLI) di Google Cloud.
-
Esegui il comando
services enable, specificando quale servizio API abilitare.gcloud services enable API_SERVICE_ID
Configurare la schermata per il consenso OAuth
Potrebbe essere necessario configurare la schermata per il consenso OAuth per il tuo progetto Cloud. Se in precedenza hai utilizzato OAuth 2.0 per l'autorizzazione, utilizza gli stessi ambiti di autorizzazione dell'accesso.
- Nella console Google Cloud, vai a Menu > API e servizi > Schermata consenso OAuth.
- Seleziona il tipo di utente per l'app e fai clic su Crea.
- Compila il modulo di registrazione dell'app, poi fai clic su Salva e continua.
Se stai creando un'app da utilizzare al di fuori della tua organizzazione Google Workspace, fai clic su Aggiungi o rimuovi ambiti. Quando selezioni gli ambiti, ti consigliamo di attenerti alle seguenti best practice:
- Seleziona gli ambiti che forniscono il livello minimo di accesso richiesto dalla tua app. Per un elenco degli ambiti disponibili, consulta Ambiti OAuth 2.0 per le API di Google.
- Esamina gli ambiti elencati in ciascuna delle tre sezioni: ambiti non sensibili, ambiti sensibili e ambiti con restrizioni. Per tutti gli ambiti elencati nelle sezioni "I tuoi ambiti sensibili" o "I tuoi ambiti con restrizioni", prova a identificare ambiti alternativi non sensibili per evitare ulteriori revisioni superflue.
- Alcuni ambiti richiedono revisioni aggiuntive da parte di Google. Per le app utilizzate solo internamente dalla tua organizzazione Google Workspace, gli ambiti non sono elencati nella schermata del consenso e l'utilizzo di ambiti con restrizioni o sensibili non richiede un'ulteriore revisione da parte di Google. Per maggiori informazioni, consulta Categorie di ambito.
- Dopo aver selezionato gli ambiti richiesti dalla tua app, fai clic su Salva e continua.
- Se hai selezionato Esterno come tipo di utente, aggiungi gli utenti di test:
- In Utenti di test, fai clic su Aggiungi utenti.
- Inserisci il tuo indirizzo email e tutti gli altri utenti di test autorizzati, quindi fai clic su Salva e continua.
- Rivedi il riepilogo della registrazione dell'app. Per apportare modifiche, fai clic su Modifica. Se la registrazione dell'app è corretta, fai clic su Torna alla dashboard.
Esegui di nuovo il deployment dell'app Chat nel nuovo progetto Cloud
A seconda che la tua app di Chat sia stata creata con Apps Script, AppSheet o con un altro tipo di connessione, come Python o Java, eseguire nuovamente il deployment dell'app di Chat è leggermente diverso. In entrambi i casi, non è necessario ricreare tutto il codice, ma devi apportare alcune modifiche.
Eseguire la migrazione della logica dell'app di Chat
A seconda dell'architettura della tua app di Chat, potresti dover eseguire la migrazione di altri servizi al nuovo progetto Cloud:
- Per le app HTTP, devi eseguire anche la migrazione del resto della logica dell'app creata utilizzando Cloud Functions, Cloud Run o App Engine.
- Per le app di chat conversazionali che utilizzano il linguaggio naturale, devi anche eseguire la migrazione degli agenti Dialogflow.
- Per le app di chat basate su un firewall, devi anche eseguire la migrazione degli argomenti Pub/Sub.
Configura l'app Chat nel nuovo progetto Cloud
Per eseguire nuovamente il deployment dell'app di Chat creata con un linguaggio come Python o Java, configura l'app nel nuovo progetto Cloud.
Nella console Google Cloud, cerca "API Google Chat" e fai clic su API Google Chat, quindi fai clic su Gestisci.
Fai clic sulla scheda Configurazione e inserisci le seguenti informazioni richieste:
- Nome app: il nome utilizzato dagli utenti quando interagiscono con la tua app Chat.
- URL avatar: un URL HTTPS che rimanda a un'immagine grafica quadrata (ad esempio, PNG o JPEG), di dimensioni minime 128 x 128, che viene visualizzata come avatar della tua app di chat.
- Descrizione: una descrizione dello scopo previsto dell'app di Chat, visualizzata sotto il nome dell'app.
Per attivare le funzionalità interattive, fai clic sul pulsante di attivazione/disattivazione Abilita funzionalità interattive che consentono agli utenti di interagire con l'app Chat e di utilizzare la seguente tabella per completare la configurazione:
Campo Descrizione Funzionalità Un insieme di campi che determinano in che modo l'app di chat può interagire con gli utenti: - Ricevere messaggi 1:1: gli utenti possono trovare l'app Chat e inviare messaggi direttamente in Google Chat.
- Partecipare a spazi e conversazioni di gruppo: gli utenti possono aggiungere l'app Chat a spazi e conversazioni di gruppo.
Impostazioni di connessione L'endpoint per l'app Chat, che è uno dei seguenti: - URL app: un endpoint HTTPS che ospita l'implementazione dell'app Chat.
- Progetto Apps Script: un ID deployment per un progetto Apps Script che implementa un'app di Chat.
- Nome argomento Cloud Pub/Sub: un argomento Pub/Sub a cui l'app Chat sottoscrive come endpoint.
- Dialogflow: registra l'app di Chat con un'integrazione Dialogflow. Per ulteriori informazioni, vedi Creare un'app Google Chat Dialogflow che comprende il linguaggio naturale.
Comandi slash Comandi che possono essere mostrati agli utenti in Google Chat. Consente agli utenti di visualizzare le azioni principali della tua app Chat in Google Chat e di scegliere un'azione specifica con cui vogliono interagire. Per ulteriori informazioni, vedi Rispondere ai comandi slash come app di Chat. Anteprime link Pattern URL che l'app di chat riconosce e fornisce contenuti aggiuntivi per quando gli utenti inviano link. Per saperne di più, consulta la sezione Link alle anteprime. Visibilità Fino a cinque persone o uno o più gruppi Google che possono visualizzare e installare la tua app di chat. Utilizza questo campo per testare l'app Chat o condividerla con il tuo team. Per saperne di più, vedi Impostazioni di visibilità e pubblicazione per l'app Chat. Per registrare gli errori in Cloud Logging ogni volta che l'app Chat restituisce un errore, seleziona la casella di controllo Registra errori in Logging. Per maggiori informazioni, consulta Log degli errori delle query per le app di Chat.
Fai clic su Salva. Quando salvi la configurazione dell'app di Chat, l'app di Chat è disponibile per gli utenti specificati nella tua organizzazione Google Workspace.
Esegui di nuovo il deployment di un'app Chat di Apps Script
Per eseguire nuovamente il deployment dell'app Chat creata con Apps Script, cambia il numero del progetto Cloud a cui è associato il progetto Apps Script con il numero di progetto che appartiene al tuo nuovo progetto Cloud. Quindi, copia l'ID deployment di Apps Script e incollalo nella pagina di configurazione dell'app Chat nella console Google Cloud.
Copia il numero di progetto Cloud
- Nella console Google Cloud, vai a Menu > IAM e amministrazione > Impostazioni.
- Nel campo Numero progetto, copia il valore.
Impostare il numero di progetto Google Cloud nel progetto Apps Script
Vai ad Apps Script.
Nel progetto Apps Script dell'app Chat, fai clic su Impostazioni progetto .
In Progetto Google Cloud Platform (GCP), fai clic su Cambia progetto.
In Numero di progetto Google Cloud, incolla il numero di progetto Google Cloud.
Fai clic su Imposta progetto.
Copia l'ID deployment del progetto Apps Script
- In alto a destra in Apps Script, fai clic su Esegui il deployment > Gestisci deployment.
- In ID deployment, fai clic su Copia.
- Fai clic su Fine.
Riconfigurare ed eseguire nuovamente il deployment dell'app Chat
Nella console Google Cloud, cerca "API Google Chat" e fai clic su API Google Chat, quindi fai clic su Gestisci.
Fai clic sulla scheda Configurazione e inserisci le seguenti informazioni richieste:
- Nome app: il nome utilizzato dagli utenti quando interagiscono con la tua app Chat.
- URL avatar: un URL HTTPS che rimanda a un'immagine grafica quadrata (ad esempio, PNG o JPEG), di dimensioni minime 128 x 128, che viene visualizzata come avatar della tua app di chat.
- Descrizione: una descrizione dello scopo previsto dell'app di Chat, visualizzata sotto il nome dell'app.
Per attivare le funzionalità interattive, fai clic sul pulsante di attivazione/disattivazione Abilita funzionalità interattive che consentono agli utenti di interagire con la tua app Chat:
In Impostazioni di connessione, seleziona Progetto Apps Script.
Nel campo ID deployment, incolla l'ID deployment che hai copiato in precedenza.
Per completare il resto della configurazione, consulta la tabella in Configurare l'app Chat nel nuovo progetto Cloud
Fai clic su Salva.
Eseguire nuovamente il deployment di un'app Chat di AppSheet
Per eseguire nuovamente il deployment dell'app di Chat creata con AppSheet nel nuovo progetto Cloud, copia l'app nel nuovo progetto Cloud.
Aggiorna l'account di servizio
Se la tua app Chat si autentica come app e utilizza un account di servizio per effettuare chiamate alle API di Google, aggiorna i dettagli dell'account di servizio dell'app Chat. Per ulteriori informazioni, consulta Autenticarsi come app di chat.
Condividere l'app Chat
Prima che l'app Chat diventi disponibile per gli utenti della nuova organizzazione, l'amministratore potrebbe dover consentire manualmente l'accesso all'app Chat. Per saperne di più, consulta l'articolo In che modo gli amministratori di Google Workspace installano le app di chat.
Passare alla nuova app Chat
Ora che hai eseguito la migrazione dell'app di Chat alla nuova organizzazione, è il momento di pubblicizzarla. Aggiungila agli spazi di Chat o ai messaggi diretti, quindi rimuovi da questi spazi la vecchia app Chat in modo che le persone inviino messaggi solo all'app Chat di cui è stata eseguita la migrazione.
Aggiungere la nuova app Chat agli spazi di Chat
Vai a Chat.
Fai clic su un messaggio diretto o uno spazio.
Fai clic sul menu a discesa accanto al nome dello spazio o della persona, quindi seleziona App e integrazioni.
Fai clic su Aggiungi app.
Inserisci il nome dell'app, selezionala dall'elenco e fai clic su Aggiungi.
Ripeti questi passaggi per ogni spazio o messaggio diretto a cui vuoi aggiungere l'app Chat.
Rimuovere la vecchia app Chat dagli spazi di Chat
Vai a Chat.
Fai clic su un messaggio diretto o uno spazio.
Fai clic sul menu a discesa accanto al nome dello spazio o della persona, quindi seleziona App e integrazioni.
Accanto alla precedente app Chat di cui non è stata eseguita la migrazione, fai clic su Altre opzioni , quindi su Rimuovi dallo spazio.
Ripeti questi passaggi per ogni spazio o messaggio diretto da cui vuoi rimuovere la vecchia app Chat.
Disattivare l'app Chat precedente
Per impedire agli utenti di utilizzare la vecchia app Chat e incoraggiarli a utilizzare la nuova app Chat, disattiva la vecchia app Chat e annulla la pubblicazione su Google Workspace Marketplace.