Cómo migrar tu app de Google Chat

Si fusionas organizaciones de Google Workspace, es posible que debas migrar tu app de Chat para que siga funcionando.

Antes de migrar tu app de Chat, consulta con el administrador de tu organización para ver si la afectan los parámetros de configuración administrativos. Si cambias un parámetro de configuración administrativo, es posible que se restablezca la funcionalidad completa de tu app de Chat y que la migración no sea necesaria. Por ejemplo, es posible que el administrador de Google Workspace deba agregar tu app de Chat a una lista de entidades permitidas o permitir que los usuarios instalen apps de Chat. Para obtener más información, consulta Cómo determinar si las apps de Google Chat deben migrarse después de combinar organizaciones de Google Workspace.

Después de determinar que necesitas migrar tu app de Chat, completa el siguiente proceso de tres pasos:

1. Configura el entorno de tu app de Chat creando un proyecto de Google Cloud en la organización combinada, habilitando APIs y, posiblemente, configurando la pantalla de consentimiento de OAuth 2.0.
2. Vuelve a implementar tu app de Chat desde el nuevo proyecto de Cloud.
3. Agrega la app de Chat recreada a los espacios o las conversaciones de Chat, y desactiva la app de Chat original.

Crea un proyecto de Cloud en la organización combinada y habilita las APIs

Crear un proyecto nuevo de Cloud y habilitar las APIs para la app de Chat en la organización combinada de Google Workspace garantiza que los usuarios y grupos a los que permitas acceder a la app de Chat puedan hacerlo sin errores.

Crea un proyecto de Cloud

Consola de Google Cloud

1. En la consola de Google Cloud, ve a Menú > IAM y administración > Crear un proyecto.

   Ir a Crear un proyecto

2. En el campo Nombre del proyecto, ingresa un nombre descriptivo para tu proyecto.

   Opcional: Para editar el ID del proyecto, haz clic en Editar. El ID del proyecto no se puede cambiar después de que se crea el proyecto. Por lo tanto, elige un ID que abarque tus necesidades durante todo el ciclo de vida del proyecto.

3. En el campo Ubicación, haz clic en Explorar para mostrar las posibles ubicaciones de tu proyecto. Luego, haga clic en Seleccionar.
   Precaución: ¿No encuentras tu organización de Google Workspace?
   Esto significa que no accediste a una cuenta de Google Workspace. Algunas de las funciones que se describen en la documentación para desarrolladores de Google Workspace solo están disponibles para los proyectos asociados a una organización.
4. Haz clic en Crear. La consola de Google Cloud te redireccionará a la página Panel y tu proyecto se creará en unos minutos.

gcloud CLI

En uno de los siguientes entornos de desarrollo, accede a Google Cloud CLI (gcloud):

• Cloud Shell: Para usar una terminal en línea con la CLI de gcloud ya configurada, activa Cloud Shell.
  Activa Cloud Shell
• Shell local: Para usar un entorno de desarrollo local, instala e inicializa la CLI de gcloud.
  Para crear un proyecto de Cloud, usa el comando gcloud projects create:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID configurando el ID del proyecto que deseas crear.

Habilita las APIs

Todas las apps de Chat deben tener habilitada la API de Google Chat. Según cómo se compile tu app de Chat, es posible que debas habilitar otras APIs. Por ejemplo, si creaste tu app de Chat con Google Cloud Functions, habilita las APIs de Cloud Build, Cloud Functions, Pub/Sub, Cloud Logging, Artifact Registry y Cloud Run. Como práctica recomendada, para asegurarte de que la app migrada funcione, habilita las mismas APIs en el nuevo proyecto de Cloud que en el proyecto de Cloud anterior.

Para habilitar una API, haz lo siguiente:

Consola de Google Cloud

1. En la consola de Google Cloud, ve a Menú > Más productos > Google Workspace > Biblioteca de productos.

   Ir a la biblioteca de productos

2. Haz clic en la API que quieras activar.
3. Haz clic en Habilitar.
4. Para habilitar más APIs, repite estos pasos.

Google Cloud CLI

1. Instala o abre la interfaz de línea de comandos (CLI) de Google Cloud.

2. Ejecuta el comando services enable y especifica qué servicio de API habilitar.

   gcloud services enable API_SERVICE_ID

Configura la API de Chat

En tu nuevo proyecto de Cloud, debes usar la API de Chat para especificar el nombre, la descripción y el ícono de tu app de Chat. Para configurar estos detalles, consulta Configura la API de Chat.

Cómo configurar la pantalla de consentimiento de OAuth

Es posible que debas configurar la pantalla de consentimiento de OAuth para tu proyecto de Cloud. Si antes usabas OAuth 2.0 para la autorización, usa los mismos permisos de acceso.

1. En la consola de Google Cloud, ve a Menú > > Branding.

   Ir a Desarrollo de la marca

2. Si ya configuraste , puedes configurar los siguientes parámetros de configuración de la pantalla de consentimiento de OAuth en Branding, Audience y Data Access. Si ves un mensaje que dice aún no se configuró, haz clic en Comenzar:
1. En Información de la aplicación, en Nombre de la app, ingresa un Nombre de la app.
2. En Correo electrónico de asistencia del usuario, elige una dirección de correo electrónico de asistencia a la que los usuarios puedan comunicarse contigo si tienen preguntas sobre su consentimiento.
3. Haz clic en Siguiente.
4. En Público, selecciona el tipo de usuario de tu app.
5. Haz clic en Siguiente.
6. En Información de contacto, ingresa una dirección de correo electrónico en la que puedas recibir notificaciones sobre cualquier cambio en tu proyecto.
7. Haz clic en Siguiente.
8. En Finalizar, revisa la Política de Datos del Usuario de los Servicios de las APIs de Google y, si la aceptas, selecciona Acepto la Política de Datos del Usuario de los Servicios de las APIs de Google.
9. Haz clic en Continuar.
10. Haz clic en Crear.
11. Si seleccionaste Externo como el tipo de usuario, agrega usuarios de prueba:
    1. Haz clic en Público.
    2. En Usuarios de prueba, haz clic en Agregar usuarios.
    3. Ingresa tu dirección de correo electrónico y los demás usuarios de prueba autorizados, y haz clic en Guardar.

3. Si creas una app para usarla fuera de tu organización de Google Workspace, haz clic en Acceso a los datos > Agregar o quitar permisos. Recomendamos las siguientes prácticas recomendadas cuando selecciones permisos:

   • Selecciona los permisos que proporcionan el nivel mínimo de acceso que requiere tu app. Si deseas obtener una lista de los permisos disponibles, consulta Permisos de OAuth 2.0 para las APIs de Google.
   • Revisa los permisos que se indican en cada una de las tres secciones: permisos no sensibles, permisos sensibles y permisos restringidos. Para los permisos que se enumeran en las secciones "Tus permisos sensibles" o "Tus permisos restringidos", intenta identificar permisos alternativos que no sean sensibles para evitar revisiones adicionales innecesarias.
   • Algunos alcances requieren revisiones adicionales por parte de Google. En el caso de las apps que solo usa internamente tu organización de Google Workspace, los permisos no se muestran en la pantalla de consentimiento y el uso de permisos sensibles o restringidos no requiere una revisión adicional por parte de Google. Para obtener más información, consulta Categorías de permisos.
4. Después de seleccionar los permisos que requiere tu app, haz clic en Guardar.

Para obtener más información sobre cómo configurar el consentimiento de OAuth, consulta Primeros pasos con .

Vuelve a implementar tu app de Chat en el nuevo proyecto de Cloud

Según si tu app de Chat se compiló con Apps Script, AppSheet o algún otro tipo de conexión, como Python o Java, la nueva implementación de tu app de Chat será un poco diferente. En cualquier caso, no es necesario que recrees todo tu código, pero sí que realices algunos cambios.

Migra la lógica de la app de Chat

Según la arquitectura de tu app de Chat, es posible que debas migrar otros servicios al nuevo proyecto de Cloud:

• En el caso de las apps HTTP, también debes migrar el resto de la lógica de la app que se compiló con Cloud Functions, Cloud Run o App Engine.
• En el caso de las apps de chat conversacionales que usan lenguaje natural, también debes migrar los agentes de Dialogflow.
• En el caso de las apps de Chat que se compilan detrás de un firewall, también debes migrar los temas de Pub/Sub.

Configura funciones interactivas en el nuevo proyecto de Cloud

Para volver a implementar tu app de Chat compilada con un lenguaje como Python o Java, configura la app de Chat en tu nuevo proyecto de Cloud.

Para configurar funciones interactivas, consulta Cómo recibir y responder a las interacciones del usuario.

Cómo volver a implementar una app de Chat de Apps Script

Para volver a implementar tu app de Chat creada con Apps Script, cambia el número del proyecto de Cloud con el que se asocia el proyecto de Apps Script por el número del proyecto que pertenece a tu nuevo proyecto de Cloud. Luego, copia el ID de implementación de Apps Script y pégalo en la página de configuración de la app de Chat en la consola de Google Cloud.

Copia el número de tu proyecto de Cloud

1. En la consola de Google Cloud, ve a Menú > IAM y administración > Configuración.

   Ir a Configuración de IAM y administración

2. En el campo Número del proyecto, copia el valor.

Configura tu número de proyecto de Google Cloud en tu proyecto de Apps Script

1. Ve a Apps Script.

   Ir a Apps Script

2. En el proyecto de Apps Script de la app de Chat, haz clic en Configuración del proyecto .

3. En Proyecto de Google Cloud, haz clic en Cambiar proyecto.

4. En Número de proyecto de GCP, pega el número de proyecto de Google Cloud.

5. Haz clic en Establecer el proyecto.

Copia el ID de implementación de tu proyecto de Apps Script

1. En la esquina superior derecha de Apps Script, haz clic en Implementar > Administrar implementaciones.
2. En ID de implementación, haz clic en Copiar.
3. Haz clic en Listo.

Reconfigura y vuelve a implementar tu app de Chat

1. En la consola de Google Cloud, busca “API de Google Chat”, haz clic en API de Google Chat y, luego, en Administrar.

   Ir a la API de Chat

2. Haz clic en la pestaña Configuración y, luego, ingresa la siguiente información obligatoria:

   • Nombre de la app: Es el nombre que usan las personas cuando interactúan con tu app de Chat.
   • URL del avatar: URL HTTPS que apunta a una imagen gráfica cuadrada (por ejemplo, PNG o JPEG), de al menos 128 x 128, que aparece como el avatar de tu app de Chat.
   • Descripción: Es una descripción del propósito previsto de la app de Chat que aparece debajo del nombre de la app.

3. Para activar las funciones interactivas, haz clic en el botón de activación Habilitar funciones interactivas que permite a los usuarios interactuar con tu app de Chat:

4. En Configuración de conexión, selecciona Proyecto de Apps Script.

5. En el campo ID de la implementación, pega el ID de implementación que copiaste anteriormente.

6. Para completar el resto de la configuración, consulta la tabla en Configura la app de Chat en el nuevo proyecto de Cloud.

7. Haz clic en Guardar.

Cómo volver a implementar una app de AppSheet Chat

Para volver a implementar tu app de Chat compilada con AppSheet en tu nuevo proyecto de Cloud, copia la app en el nuevo proyecto de Cloud.

Actualiza la cuenta de servicio

Si tu app de Chat se autentica como una app y usa una cuenta de servicio para realizar llamadas a las APIs de Google, actualiza los detalles de la cuenta de servicio de la app de Chat. Para obtener más información, consulta Cómo autenticarse como una app de Chat.

Comparte tu app de Chat

Antes de que tu app de Chat esté disponible para los usuarios de la nueva organización, es posible que el administrador deba permitir manualmente el acceso a la app de Chat. Para obtener más información, consulta Cómo configurar el acceso para las organizaciones de Google Workspace en la documentación de Google Workspace Marketplace.

Cómo cambiar a la nueva app de Chat

Ahora que la app de Chat se migró a la nueva organización, es momento de publicitarla. Agrégala a los espacios de Chat o a los mensajes directos y, luego, quita la app de Chat anterior de ellos para que las personas solo envíen mensajes a la app de Chat migrada.

Práctica recomendada: Para facilitar la adopción de la app de Chat migrada, anuncia la migración a tus usuarios y anímalos a instalar la app de Chat migrada en los espacios y las conversaciones de Chat.

Agrega la nueva app de Chat a los espacios de Chat

1. Ve a Chat.

   Ir a Chat

2. Haz clic en un mensaje directo o un espacio.

3. Haz clic en el menú desplegable junto al nombre del espacio o la persona y, luego, selecciona Apps y complementos.

4. Haz clic en Agregar apps.

5. Ingresa el nombre de la app, selecciónala de la lista y, luego, haz clic en Agregar.

6. Repite estos pasos para cada espacio o mensaje directo al que quieras agregar la app de Chat.

Cómo quitar la app de Chat anterior de los espacios de Chat

1. Ve a Chat.

   Ir a Chat

2. Haz clic en un mensaje directo o un espacio.

3. Haz clic en el menú desplegable junto al nombre del espacio o la persona y, luego, selecciona Apps y complementos.

4. Junto a la app de Chat anterior que no se migró, haz clic en Más opciones y, luego, en Quitar del espacio.

5. Repite estos pasos para cada espacio o mensaje directo del que quieras quitar la app de Chat anterior.

Cómo desactivar la app de Chat anterior

Para evitar que los usuarios usen la app de Chat anterior y alentarlos a que usen la nueva, desactiva la app de Chat anterior y anula su publicación en Google Workspace Marketplace.