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, rivolgiti all'amministratore della tua organizzazione per verificare se le impostazioni di amministrazione influiscono sull'app. 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 l'app Chat a una lista consentita o dover consentire agli utenti di installare app di Chat. Per saperne di più, consulta Determinare se è necessario eseguire la migrazione delle app di Google Chat dopo l'unione di organizzazioni Google Workspace.
Dopo aver stabilito che devi eseguire la migrazione della tua app Chat, completa la seguente procedura in tre passaggi:
- Configura l'ambiente per l'app Chat creando un progetto Google Cloud nell'organizzazione unita, attivando le API e, eventualmente, configurando la schermata per il consenso OAuth 2.0.
- Ridistribuisci l'app Chat dal nuovo progetto Cloud.
- Aggiungi l'app Chat ricreata agli spazi o alle conversazioni di Chat e disattiva l'app Chat originale.
Crea un progetto Cloud nell'organizzazione unita e abilita le API
La creazione di un nuovo progetto Cloud e l'abilitazione delle API per l'app Chat nell'organizzazione Google Workspace unita garantisce che gli utenti e i gruppi a cui consenti di accedere all'app Chat possano farlo senza errori.
Creazione di un progetto 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 l'intera durata del progetto.
- Nel campo Località, fai clic su Sfoglia per visualizzare le potenziali località per il tuo progetto. Quindi, fai clic su Seleziona.
- Fai clic su Crea. La console Google Cloud passa alla pagina Dashboard e il progetto viene creato entro pochi minuti.
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.
Attiva Cloud Shell -
Shell locale: per utilizzare un ambiente di sviluppo locale,
installa e
inizializza
l'interfaccia a riga di comando gcloud.
Per creare un progetto Cloud, utilizza il comandogcloud projects create:gcloud projects createPROJECT_ID
Abilita API
È obbligatorio che tutte le app di Chat abbiano attivato l'API Google Chat. A seconda di come è stata creata l'app Chat, potrebbe essere necessario attivare altre API. Ad esempio, se hai creato la tua app di chat utilizzando Google Cloud Functions, attiva 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 le stesse API nel nuovo progetto Cloud che sono abilitate nel vecchio progetto Cloud.
Per abilitare un'API:
- Nella console Google Cloud, vai a Menu > Altri prodotti > Google Workspace > Raccolta prodotti.
- Fai clic sull'API che vuoi attivare.
- Fai clic su Abilita.
- Per attivare altre API, ripeti questi passaggi.
- Installa o apri l'interfaccia a riga di comando (CLI) Google Cloud.
-
Esegui il comando
services enable, specificando il servizio API da abilitare.gcloud services enable
API_SERVICE_ID
Configurare l'API Chat
Nel nuovo progetto Cloud, devi utilizzare l'API Chat per specificare il nome, la descrizione e l'icona della tua app Chat. Per configurare questi dettagli, consulta Configurare l'API Chat
Configura la schermata per il consenso OAuth
Potrebbe essere necessario configurare la schermata per il consenso OAuth per il progetto Cloud. Se in precedenza utilizzavi OAuth 2.0 per l'autorizzazione, utilizza gli stessi ambiti di autorizzazione di accesso.
- Nella console Google Cloud, vai a Menu > > Branding.
- Se hai già configurato il , puoi configurare le seguenti impostazioni della schermata per il consenso OAuth in Branding, Pubblico e Accesso ai dati. Se viene visualizzato il messaggio non ancora configurato, fai clic su Inizia:
- In Informazioni sull'app, inserisci un nome dell'app in Nome dell'app.
- In Indirizzo email dell'assistenza utente, scegli un indirizzo email dell'assistenza a cui gli utenti possono contattarti in caso di domande sul loro consenso.
- Fai clic su Avanti.
- In Pubblico, seleziona il tipo di utente per la tua app.
- Fai clic su Avanti.
- In Informazioni di contatto, inserisci un indirizzo email a cui ricevere notifiche di eventuali modifiche al progetto.
- Fai clic su Avanti.
- In Fine, esamina le Norme relative ai dati utente dei servizi API di Google e, se accetti, seleziona Accetto le Norme relative ai dati utente: servizi API di Google.
- Fai clic su Continua.
- Fai clic su Crea.
- Se hai selezionato Esterno come tipo di utente, aggiungi gli utenti di test:
- Fai clic su Pubblico.
- In Utenti di test, fai clic su Aggiungi utenti.
- Inserisci il tuo indirizzo email e gli altri utenti di test autorizzati, quindi fai clic su Salva.
Se stai creando un'app da utilizzare al di fuori della tua organizzazione Google Workspace, fai clic su Accesso ai dati > Aggiungi o rimuovi ambiti. Ti consigliamo le seguenti best practice per la selezione degli ambiti:
- 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 gli ambiti elencati nelle sezioni "I tuoi ambiti sensibili" o "I tuoi ambiti con limitazioni", prova a identificare ambiti non sensibili alternativi per evitare ulteriori revisioni non necessarie.
- Alcuni ambiti richiedono ulteriori revisioni 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 limitazioni o sensibili non richiede un'ulteriore revisione da parte di Google. Per ulteriori informazioni, consulta Categorie di ambito.
- Dopo aver selezionato gli ambiti richiesti dalla tua app, fai clic su Salva.
Per ulteriori informazioni sulla configurazione del consenso OAuth, consulta la guida introduttiva a .
Ridistribuisci l'app di Chat nel nuovo progetto Cloud
A seconda che l'app di Chat sia creata con Apps Script, AppSheet o un altro tipo di connessione, come Python o Java, il redeployment dell'app di Chat è leggermente diverso. In entrambi i casi, non è necessario ricreare tutto il codice, ma è necessario apportare alcune modifiche.
Esegui la migrazione della logica dell'app Chat
A seconda dell'architettura dell'app di Chat, potrebbe essere necessario eseguire la migrazione di altri servizi al nuovo progetto Cloud:
- Per le app HTTP, devi eseguire la migrazione anche del resto della logica dell'app che è stata 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 create dietro un firewall, devi anche eseguire la migrazione degli argomenti Pub/Sub.
Configura le funzionalità interattive nel nuovo progetto Cloud
Per eseguire nuovamente il deployment dell'app di Chat creata con un linguaggio come Python o Java, configura l'app di Chat nel nuovo progetto Cloud.
Per configurare le funzionalità interattive, consulta Ricevere e rispondere alle interazioni utente.
Ridistribuire un'app di Chat di Apps Script
Per eseguire nuovamente il deployment dell'app di Chat creata con Apps Script, modifica il numero del progetto Cloud a cui è associato il progetto Apps Script con il numero del progetto che appartiene al nuovo progetto Cloud. Quindi, copia l'ID di deployment di Apps Script e incollalo nella pagina di configurazione dell'app Chat nella console Google Cloud.
Copia il numero del progetto Cloud
- Nella console Google Cloud, vai a Menu > IAM e amministrazione > Impostazioni.
- Nel campo Numero progetto, copia il valore.
Impostare il numero del 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 (Google Cloud), fai clic su Cambia progetto.
In Numero progetto Google Cloud, incolla il numero del 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 i deployment.
- In ID deployment, fai clic su Copia.
- Fai clic su Fine.
Riconfigura ed esegui nuovamente il deployment dell'app di Chat
Nella console Google Cloud, cerca "API Google Chat" e fai clic su API Google Chat, poi fai clic su Gestisci.
Fai clic sulla scheda Configurazione e inserisci le seguenti informazioni obbligatorie:
- Nome dell'app: il nome utilizzato dagli utenti quando interagiscono con la tua app di chat.
- URL avatar: un URL HTTPS che rimanda a un'immagine grafica quadrata (ad esempio PNG o JPEG), di almeno 128 x 128, che viene visualizzata come avatar per la tua app Chat.
- Descrizione: una descrizione dello scopo previsto dell'app Chat, visualizzata sotto il nome dell'app.
Per attivare le funzionalità interattive, fai clic sul pulsante di attivazione/disattivazione Attiva funzionalità interattive che consente agli utenti di interagire con la tua app Chat:
In Impostazioni di connessione, seleziona Progetto Apps Script.
Nel campo Deployment ID (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.
Ridistribuire un'app di chat AppSheet
Per eseguire nuovamente il deployment dell'app di Chat creata con AppSheet nel nuovo progetto Cloud, copia l'app nel nuovo progetto Cloud.
Aggiornare 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 maggiori informazioni, vedi 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. Per ulteriori informazioni, consulta Come gli amministratori di Google Workspace installano le app di Chat.
Passare alla nuova app Chat
Ora che è stata eseguita la migrazione dell'app Chat alla nuova organizzazione, è il momento di pubblicizzarla. Aggiungilo agli spazi Chat o ai messaggi diretti, quindi rimuovi l'app Chat obsoleta 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 l'app Chat precedente 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 vecchia app Chat di cui non è stata eseguita la migrazione, fai clic su Altre opzioni e poi 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 l'app Chat obsoleta e incoraggiarli a utilizzare la nuova app Chat, disattiva l'app Chat obsoleta e annulla la sua pubblicazione da Google Workspace Marketplace.