Se unisci le organizzazioni Google Workspace, potresti dover eseguire la migrazione dell'app di chat in modo che continui a funzionare.
Prima di eseguire la migrazione dell'app di chat, chiedi all'amministratore della tua organizzazione se le impostazioni di amministrazione la interessano. La modifica di un'impostazione di amministrazione potrebbe ripristinare la funzionalità completa dell'app di chat e rendere non necessaria la migrazione. Ad esempio, l'amministratore di Google Workspace potrebbe dover aggiungere l'app di chat a una lista consentita o consentire agli utenti di installare le app di chat. Per saperne di più, vedi Determinare 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 di chat, completa la seguente procedura in tre passaggi:
- Configura l'ambiente per l'app di chat creando un progetto Google Cloud nell'organizzazione unita, abilitando le API e, se necessario, configurando la schermata per il consenso OAuth 2.0.
- Esegui nuovamente il deployment dell'app di chat dal nuovo progetto Cloud.
- Aggiungi l'app di chat ricreata agli spazi o alle conversazioni di Chat e disattiva l'app di 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 di chat nell'organizzazione Google Workspace unita garantiscono che gli utenti e i gruppi a cui consenti di accedere all'app di chat possano farlo senza errori.
Crea 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 la 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 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à configurata, attiva Cloud Shell.
Attiva Cloud Shell -
Shell locale: per utilizzare un ambiente di sviluppo locale,
installa e
inizializza
gcloud CLI.
Per creare un progetto Cloud, utilizza il comandogcloud projects create:gcloud projects create PROJECT_ID
Abilita API
Tutte le app di chat devono avere l'API Google Chat abilitata. A seconda di come è stata creata l'app di chat, potresti dover abilitare altre API. Ad esempio, se hai creato l'app di 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 le stesse API nel nuovo progetto Cloud che sono abilitate nel vecchio progetto Cloud.
Per abilitare un'API:
Console Google Cloud
- Nella console Google Cloud, vai a Menu > API e servizi > Libreria > Google Workspace.
- Fai clic sull'API che vuoi attivare.
- Fai clic su Abilita.
- Per abilitare altre API, ripeti questi passaggi.
Google Cloud CLI
- Installa o apri l'interfaccia a riga di comando (CLI) di Google Cloud.
-
Esegui il comando
services enable, specificando il servizio API da abilitare.gcloud services enable API_SERVICE_ID
Configura l'API Chat
Nel nuovo progetto Cloud, devi utilizzare l'API Chat per specificare il nome, la descrizione e l'icona dell'app di chat. Per configurare questi dettagli, vedi 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 hai utilizzato OAuth 2.0 per l'autorizzazione, utilizza gli stessi ambiti di accesso per l'autorizzazione.
- Nella console API di Google, vai a Menu > Piattaforma Google Auth > Branding.
- Se hai già configurato la piattaforma Google Auth, puoi configurare le seguenti impostazioni della schermata per il consenso OAuth in Branding, Pubblico e Accesso ai dati. Se visualizzi il messaggio Google Auth Platform non ancora configurata, fai clic su Inizia:
- In Informazioni sull'app, nel campo Nome app, inserisci un nome app.
- In Email di assistenza utente, scegli un indirizzo email di assistenza a cui gli utenti possono contattarti in caso di domande sul consenso.
- Fai clic su Avanti.
- In Pubblico, seleziona il tipo di utente per l'app.
- Fai clic su Avanti.
- In Dati di contatto, inserisci un indirizzo email a cui ricevere notifiche in caso di modifiche al progetto.
- Fai clic su Avanti.
- In Fine , esamina le Norme relative ai dati utente dei servizi API di Google e, se le 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 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, vedi 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 restrizioni", 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 per il consenso e l'utilizzo di ambiti con restrizioni o sensibili non richiede ulteriori revisioni da parte di Google. Per saperne di più, vedi Categorie di ambiti.
- Dopo aver selezionato gli ambiti richiesti dall'app, fai clic su Salva.
Per saperne di più sulla configurazione del consenso OAuth, vedi Inizia a utilizzare la piattaforma Google Auth.
Esegui nuovamente il deployment dell'app di chat nel nuovo progetto Cloud
A seconda che l'app di chat sia stata creata con Apps Script, AppSheet o un altro tipo di connessione, come Python o Java, la procedura di nuovo deployment è leggermente diversa. In entrambi i casi, non devi ricreare tutto il codice, ma devi apportare alcune modifiche.
Esegui la migrazione della logica dell'app di chat
A seconda dell' architettura dell'app di chat, potresti dover eseguire la migrazione di altri servizi al nuovo progetto Cloud:
- Per le app HTTP, devi anche eseguire la migrazione del resto della logica dell'app creata utilizzando le funzioni Cloud Run, 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 rieseguire 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, vedi Ricevere e rispondere alle interazioni degli utenti.
Esegui nuovamente il deployment di un'app di chat di Apps Script
Per rieseguire 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 del nuovo progetto Cloud. Poi, copia l'ID deployment di Apps Script e incollalo nella pagina di configurazione dell'app di chat nella console API di Google.
Copia il numero del progetto Cloud
- Nella console API di Google, vai a Menu > IAM e amministrazione > Impostazioni.
- Nel campo Numero progetto, copia il valore.
Imposta il numero del progetto cloud Google nel progetto Apps Script
Vai ad Apps Script.
Nel progetto Apps Script dell'app di chat, fai clic su Impostazioni progetto .
In Progetto Google Cloud Platform (Google Cloud), fai clic su Modifica 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 Esegui il deployment > Gestisci deployment.
- In ID deployment, fai clic su Copia.
- Fai clic su Fine.
Riconfigura ed esegui nuovamente il deployment dell'app di chat
Nella console API di Google, cerca "API Google Chat", fai clic su API Google Chat e poi su Gestisci.
Fai clic sulla scheda Configurazione e inserisci le seguenti informazioni obbligatorie:
- Nome app: il nome che gli utenti utilizzano quando interagiscono con l' 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 pixel, che viene visualizzata come avatar per l'app di chat.
- Descrizione: una descrizione dello scopo previsto dell' app di chat che viene visualizzata sotto il nome dell'app di chat.
Per attivare le funzionalità interattive, fai clic sul pulsante Abilita funzionalità interattive che consente agli utenti di interagire con l'app di 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 the Configurare l'app di chat nel nuovo progetto Cloud
Fai clic su Salva.
Esegui nuovamente il deployment di un'app di chat di AppSheet
Per rieseguire 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 l'app di Chat esegue l'autenticazione come app e utilizza un account di servizio per effettuare chiamate alle API di Google, aggiorna i dettagli dell'account di servizio dell'app di Chat. Per saperne di più, vedi Eseguire l'autenticazione come app di chat.
Condividi l'app di chat
Prima che l'app di chat diventi disponibile per gli utenti della nuova organizzazione, l' amministratore potrebbe dover consentire manualmente l'accesso all' app di chat. Per saperne di più, consulta Configurare l'accesso per le organizzazioni Google Workspace nella documentazione di Google Workspace Marketplace.
Passa alla nuova app di chat
Ora che è stata eseguita la migrazione dell'app di chat alla nuova organizzazione, è il momento di pubblicizzarla. Aggiungila agli spazi o ai messaggi diretti di Chat e poi rimuovi la vecchia app di chat in modo che gli utenti inviino messaggi solo all'app di chat di cui è stata eseguita la migrazione.
Aggiungi la nuova app di 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 e poi seleziona App e integrazioni.
Fai clic su Aggiungi app.
Inserisci il nome dell'app, selezionala dall'elenco e poi fai clic su Aggiungi.
Ripeti questi passaggi per ogni spazio o messaggio diretto a cui vuoi aggiungere l'app di chat.
Rimuovi la vecchia app di 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 e poi seleziona App e integrazioni.
Accanto alla vecchia app di 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 di chat.
Disattiva la vecchia app di chat
Per impedire agli utenti di utilizzare la vecchia app di chat e incoraggiarli a utilizzare la nuova app di chat, disattiva la vecchia app di chat e annulla la pubblicazione da Google Workspace Marketplace.