Se unisci le organizzazioni Google Workspace, potresti dover eseguire la migrazione l'app di chat per continuare a funzionare.
Prima di eseguire la migrazione dell'app Chat, verifica con il tuo dell'organizzazione per controllare se le impostazioni amministrative che lo interessano. La modifica di un'impostazione amministrativa potrebbe ripristinare la disponibilità completa all'app Chat ed eseguire la migrazione inutili. Ad esempio, l'amministratore di Google Workspace potrebbe aver per aggiungere l'app Chat a una lista consentita o potrebbe essere necessario per consentire agli utenti di installare app di chat. Per ulteriori informazioni, vedi Determina se è necessario eseguire la migrazione delle app Google Chat dopo l'unione delle organizzazioni Google Workspace.
Dopo aver stabilito che devi eseguire la migrazione L'app Chat completa la seguente procedura in tre passaggi:
- Configura l'ambiente per l'app di Chat creare un progetto Google Cloud nell'organizzazione unita, abilitare le API e la potenziale configurazione della schermata per il consenso OAuth 2.0.
- Esegui di nuovo il deployment dell'app Chat dal nuovo progetto cloud.
- Aggiungere l'app Chat ricreata a Chat spazi o conversazioni e disattiva l'originale Chat.
Crea un progetto Cloud nell'organizzazione unita e abilita le API
La creazione di un nuovo progetto Cloud e l'abilitazione delle API per App di Chat nell'organizzazione Google Workspace unita assicurati che gli utenti e i gruppi a cui hai consentito l'accesso L'app Chat può farlo senza errori.
Creazione di un progetto cloud
Console Google Cloud
- Nella console Google Cloud, vai al Menu > IAM e Amministratore > 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 creato dopo la creazione del progetto, quindi scegli un ID che soddisfi le tue esigenze per tutta la durata progetto.
- Nel campo Località, fai clic su Sfoglia per visualizzare le località potenziali per il tuo progetto. Poi, fai clic su Seleziona.
- Fai clic su Crea. La console Google Cloud accede 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 Interfaccia a riga di comando ("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,
install e
inizializzare
con 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 API
Tutte le app di Chat devono disporre dell'API Google Chat in un bucket con il controllo delle versioni attivo. A seconda di come è stata creata la tua app di chat, potrebbe essere necessario abilitare altre API. Ad esempio, se creato la tua app di chat utilizzando Google Cloud Functions, abilitare l'API Cloud Build, l'API Cloud Functions, l'API Pub/Sub, l'API Cloud Logging, API Artifact Registry e API Cloud Run. Come best practice, per garantire che di Google Cloud, abilita le stesse API nel nuovo progetto Cloud che sono abilitate nel progetto Cloud precedente.
Per abilitare un'API:
Console Google Cloud
- Nella console Google Cloud, vai al Menu > Altri prodotti > Google Workspace > Libreria 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 quale servizio API abilitare.gcloud services enable API_SERVICE_ID
Configura l'API Chat
Nel tuo nuovo progetto Cloud, devi utilizzare l'API Chat per specificare il nome, la descrizione e l'icona dell'app di Chat. A configurare questi dettagli, consulta Configura l'API Chat
Configurare la schermata per il consenso OAuth
Potrebbe essere necessario configurare la schermata per il consenso OAuth progetto cloud. Se in precedenza hai utilizzato OAuth 2.0 per l'autorizzazione, utilizza gli stessi ambiti di autorizzazione di accesso.
- Nella console Google Cloud, vai al Menu > API e Servizi > Schermata consenso OAuth.
- Seleziona il tipo di utente per la tua app, poi fai clic su Crea.
- Compila il modulo di registrazione dell'app, quindi fai clic su Salva e continua.
Se stai creando un'app da utilizzare al di fuori di Google Workspace dell'organizzazione, fai clic su Aggiungi o rimuovi ambiti. Ti consigliamo di attenerti alle seguenti best practice quando selezione degli ambiti:
- Seleziona gli ambiti che forniscono il livello minimo di accesso richiesto dalla tua app. Per un elenco di gli ambiti disponibili, vedi Ambiti OAuth 2.0 per le API di Google.
- Esamina gli ambiti elencati in ciascuna delle tre sezioni: non sensibili sensibili, sensibili e con restrizioni. Per gli ambiti elencati nella "I tuoi ambiti sensibili" o "I tuoi ambiti con restrizioni" prova a identificare ambiti non sensibili alternativi per evitare revisioni aggiuntive non necessarie.
- Alcuni ambiti richiedono revisioni aggiuntive da parte di Google. Solo per app usate gli ambiti non sono elencati nella schermata per il consenso e l'uso di ambiti con restrizioni o sensibili non richiede un'ulteriore revisione da parte di Google. Per ulteriori informazioni, vedi Categorie di ambito.
- Dopo aver selezionato gli ambiti richiesti dall'app, fai clic su Salva e continua.
- Se hai selezionato Esterni come tipo di utente, aggiungi utenti di test:
- .
- In Utenti di test, fai clic su Aggiungi utenti.
- Inserisci il tuo indirizzo email e gli eventuali altri utenti di test autorizzati, quindi fai clic su Salva e continua.
- Esamina il riepilogo della registrazione dell'app. Per apportare modifiche, fai clic su Modifica. Se l'app la registrazione sembra a posto, fai clic su Torna alla Dashboard.
Esegui di nuovo il deployment dell'app di Chat nel nuovo progetto Cloud
A seconda che l'app di Chat sia integrata o meno Apps Script, AppSheet o un altro tipo di connessione, come Python o Java, il redeployment dell'app di Chat è diverso poco. In entrambi i casi, non è necessario ricreare tutto il codice, devi apportare delle modifiche.
Eseguire la migrazione della logica dell'app di Chat
In base l'architettura dell'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 è stato creato utilizzando Cloud Functions, Cloud Run o App Engine.
- Per le app di chat conversazionali che utilizzano il linguaggio naturale, e necessiti di eseguire anche la migrazione degli agenti Dialogflow.
- Per le app di chat protette da un firewall, puoi anche per eseguire la migrazione degli argomenti Pub/Sub.
Configura 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 Chat un nuovo progetto Cloud.
Per configurare le funzionalità interattive, vedi Ricevere e rispondere alle interazioni degli utenti.
Eseguire di nuovo 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 che Il progetto Apps Script è associato al numero del progetto che appartiene al tuo nuovo progetto Cloud. Quindi, copia l'ID deployment di Apps Script e incollalo nel pagina di configurazione dell'app di chat nella console Google Cloud.
Copia il numero del tuo progetto Cloud
- Nella console Google Cloud, vai al Menu > IAM e Amministratore > Impostazioni.
- Copia il valore nel campo Numero progetto.
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 (Google Cloud), 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
- Nell'angolo in alto a destra di Apps Script, fai clic su Esegui il deployment > Gestire i deployment.
- In ID deployment, fai clic su Copia.
- Fai clic su Fine.
Riconfigura ed esegui di nuovo 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 quanto segue informazioni:
- Nome app: il nome utilizzato dalle persone quando interagiscono con il tuo Chat.
- URL avatar: un URL HTTPS che rimanda a un'immagine grafica quadrata. (ad esempio, PNG o JPEG), di almeno 128 x 128, viene visualizzato come avatar per la tua app Chat.
- Descrizione: una descrizione del La finalità prevista dell'app di chat, che viene visualizzata sotto il nome della tua app di Chat.
Per attivare le funzionalità interattive, fai clic su Attiva le funzionalità interattive. pulsante di attivazione/disattivazione che consente agli utenti di interagire App Chat:
In Impostazioni di connessione, seleziona Progetto Apps Script.
Nel campo ID deployment, incolla l'ID deployment che hai precedentemente copiato.
Per completare il resto della configurazione, consulta la tabella nella Configura l'app Chat nel nuovo progetto Cloud
Fai clic su Salva.
Esegui di nuovo il deployment di un'app AppSheet Chat
Per rieseguire il deployment dell'app di chat creata con AppSheet nel tuo nuovo progetto Cloud, copiare l'app nel nuovo progetto Cloud.
Aggiorna l'account di servizio
Se la tua app Chat si autentica come app e utilizza un l'account di servizio per effettuare chiamate alle API di Google, aggiorna Dettagli dell'account di servizio dell'app Chat. Per ulteriori informazioni le informazioni, vedi Esegui l'autenticazione come app di Chat.
Condividere l'app Chat
Prima che l'app Chat diventi disponibile per gli utenti nel nuova organizzazione, potrebbe dover consentire manualmente l'accesso Chat. Per ulteriori informazioni, consulta le 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 Chat alla nuova organizzazione, è il momento di pubblicizzarla. Aggiungilo agli spazi di Chat o messaggi diretti e rimuovere la versione precedente dell'app Chat in modo che le persone inviino messaggi solo alle Chat.
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 che vuoi aggiungere. l'app Chat.
Rimuovere l'app di 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 e poi seleziona App e integrazioni.
Accanto alla vecchia app Chat di cui non è stata eseguita la migrazione, fai clic su Altre opzioni , quindi fai clic su Rimuovi dallo spazio.
Ripeti questi passaggi per ogni spazio o messaggio diretto che vuoi rimuovere. dalla vecchia app Chat.
Disattivare l'app Chat precedente
Impedire agli utenti di utilizzare la versione precedente dell'app Chat e per incoraggiarli a usare la nuova app Chat, disattivare l'app Chat precedente e annullarne la pubblicazione su Google Workspace Marketplace.