Se unisci le organizzazioni Google Workspace, potresti dover eseguire la migrazione dell'app Chat affinché continui a funzionare.
Prima di eseguire la migrazione dell'app Chat, chiedi all'amministratore della tua organizzazione se le impostazioni amministrative la interessano. La modifica di un'impostazione amministrativa potrebbe ripristinare la piena funzionalità 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 potrebbe dover consentire agli utenti di installare app Chat. Per saperne di più, vedi Determinare se le app Google Chat devono essere migrate dopo l'unione delle 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 la tua app 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 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'attivazione 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
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 l'intera durata del progetto.
- Nel campo Posizione, fai clic su Sfoglia per visualizzare le potenziali posizioni 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.
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.
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 è creata l'app Chat, potresti dover abilitare altre API. Ad esempio, se hai creato la tua 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 abilitate nel vecchio 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.
- 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
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 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 tuo progetto Cloud. Se in precedenza hai utilizzato OAuth 2.0 per l'autorizzazione, utilizza gli stessi ambiti di accesso per l'autorizzazione.
- Nella console Google Cloud, vai a Menu > > Branding.
- Se hai già configurato , 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 configurata, fai clic su Inizia:
- In Informazioni sull'app, nel campo Nome app, inserisci un nome app.
- In 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 in caso di modifiche al tuo 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 dei servizi API di Google.
- Fai clic su Continua.
- Fai clic su Crea.
- Se hai selezionato Esterno per il tipo di utente, aggiungi utenti di test:
- Fai clic su Segmento di pubblico.
- Nella sezione 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. 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 limitazioni. Per tutti gli ambiti elencati nelle sezioni "I tuoi ambiti sensibili" o "I tuoi ambiti con limitazioni", prova a identificare ambiti alternativi non sensibili 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 sensibili o con limitazioni non richiede un'ulteriore revisione da parte di Google. Per maggiori informazioni, vedi Categorie di ambiti.
- Dopo aver selezionato gli ambiti richiesti dalla tua app, fai clic su Salva.
Per maggiori informazioni sulla configurazione del consenso OAuth, consulta la pagina Guida introduttiva all' .
Esegui di nuovo il deployment dell'app di chat nel nuovo progetto Cloud
A seconda che l'app Chat sia creata con Apps Script, AppSheet o un altro tipo di connessione, come Python o Java, il redeployment dell'app 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 Chat
A seconda dell'architettura della tua app di chat, potresti dover eseguire la migrazione di altri servizi al nuovo progetto Google Cloud:
- Per le app HTTP, devi anche eseguire 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 create dietro un firewall, devi anche migrare gli 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 tuo nuovo progetto Cloud.
Per configurare le funzionalità interattive, vedi Ricevere e rispondere alle interazioni degli utenti.
Eseguire nuovamente il deployment di un'app Chat Apps Script
Per eseguire nuovamente il deployment dell'app Chat creata con Apps Script, modifica il numero di progetto Cloud a cui è associato il progetto Apps Script con il numero di progetto che appartiene al nuovo progetto Cloud. Poi, copia l'ID 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 di 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 (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 di chat
Nella console Google Cloud, cerca "API Google Chat" e fai clic su API Google Chat, poi su Gestisci.
Fai clic sulla scheda Configurazione e inserisci le seguenti informazioni obbligatorie:
- 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 esempio PNG o JPEG), di almeno 128 x 128 pixel, che viene visualizzata come avatar per l'app Chat.
- Descrizione: una descrizione dello scopo previsto dell'app Chat che viene visualizzata sotto il nome dell'app Chat.
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 ID deployment, incolla l'ID deployment che hai copiato in precedenza.
Per completare il resto della configurazione, consulta la tabella nella sezione Configurare l'app di chat nel nuovo progetto Cloud.
Fai clic su Salva.
Eseguire nuovamente il deployment di un'app di 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.
Aggiornare il service account
Se la tua app di Chat esegue l'autenticazione come app e utilizza un service account per effettuare chiamate alle API di Google, aggiorna i dettagli del service account dell'app di Chat. Per ulteriori informazioni, vedi Eseguire l'autenticazione come app di Chat.
Condividere l'app Chat
Prima che la tua app di chat diventi disponibile per gli utenti della nuova organizzazione, il tuo amministratore potrebbe dover consentire manualmente l'accesso all'app di chat. Per ulteriori informazioni, consulta Configurare l'accesso per le organizzazioni Google Workspace nella documentazione di Google Workspace Marketplace.
Passare alla nuova app Chat
Ora che l'app di chat è stata migrata nella nuova organizzazione, è il momento di pubblicizzarla. Aggiungilo agli spazi di Chat o ai messaggi diretti, quindi rimuovi 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 e poi 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 e poi seleziona App e integrazioni.
Accanto alla vecchia 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 obsoleta
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 da Google Workspace Marketplace.