Cómo migrar tu app de Google Chat

Si combinas 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 no sea necesario realizar la migración. 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 Determina si las apps de Google Chat deben migrarse después de combinar organizaciones de Google Workspace.

Después de determinar que debes 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 las APIs y, posiblemente, configurando la pantalla de consentimiento de OAuth 2.0.
2. Vuelve a implementar tu app de Chat desde el proyecto nuevo 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

Si creas un proyecto nuevo de Cloud y habilitas las APIs para la app de Chat en la organización combinada de Google Workspace, te aseguras de que los usuarios y los grupos a los que permites 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 con una organización.
4. Haz clic en Crear. La consola de Google Cloud navega a la página Panel y tu proyecto se crea 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.
  Activar Cloud Shell
• Shell local: Para usar un entorno de desarrollo local, instala y inicializa la gcloud CLI.
  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 compilaste tu app de Chat con Google Cloud Functions, habilita la API de Cloud Build, la API de Cloud Functions, la API de Pub/Sub, la API de Cloud Logging, la API de Artifact Registry y la API de Cloud Run. Como práctica recomendada, para asegurarte de que la app migrada funcione, habilita las mismas APIs en el proyecto nuevo de Cloud que están habilitadas en el proyecto anterior de Cloud.

Para habilitar una API, haz lo siguiente:

Consola de Google Cloud

1. En la consola de Google Cloud, ve a Menú > APIs y servicios > Biblioteca > Google Workspace.

   Ir a la biblioteca de la API

2. Haz clic en la API que deseas 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 proyecto nuevo 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 APIs de Google, ve a Menú > Plataforma de autenticación de Google > Información de la marca.

   Ir a Información de la marca

2. Si ya configuraste la plataforma de autenticación de Google, puedes configurar los siguientes parámetros de configuración de la pantalla de consentimiento de OAuth en Información de la marca, Público y Acceso a los datos. Si ves un mensaje que dice Aún no se configuró la plataforma de autenticación de Google, haz clic en Comenzar:
1. En Información de la aplicación, en Nombre de la aplicación, ingresa un Nombre de la aplicación.
2. En Correo electrónico de asistencia al usuario, elige una dirección de correo electrónico de asistencia en 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 para 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 estás de acuerdo, 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 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 usar fuera de tu organización de Google Workspace, haz clic en Acceso a los datos > Agregar o quitar permisos. Recomendamos las siguientes prácticas cuando seleccionas permisos:

   • Selecciona los permisos que proporcionan el nivel mínimo de acceso que requiere tu app. Para obtener una lista de los permisos disponibles, consulta Permisos de OAuth 2.0 para las APIs de Google.
   • Revisa los permisos que se enumeran en cada una de las tres secciones: permisos no sensibles permisos sensibles y permisos restringidos. Para cualquier permiso que se enumere en las secciones "Tus permisos sensibles" o "Tus permisos restringidos", intenta identificar permisos alternativos no sensibles para evitar revisiones adicionales innecesarias.
   • Algunos permisos requieren revisiones adicionales de Google. En el caso de las apps que usa solo internamente tu organización de Google Workspace, los permisos no aparecen en la pantalla de consentimiento, y el uso de permisos restringidos o sensibles no requiere una revisión adicional 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 la configuración del consentimiento de OAuth, consulta Cómo comenzar a utilizar la plataforma de autenticación de Google.

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

Según si tu app de Chat se compila con Apps Script, AppSheet o algún otro tipo de conexión, como Python o Java, la forma de volver a implementar tu app de Chat difiere un poco. En cualquier caso, no es necesario que vuelvas a crear todo el código, pero sí debes realizar 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 proyecto nuevo 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 funciones de Cloud Run, 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 las funciones interactivas en el proyecto nuevo 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 proyecto nuevo de Cloud.

Para configurar las funciones interactivas, consulta Recibe y responde a las interacciones del usuario.

Vuelve a implementar una app de Chat de Apps Script

Para volver a implementar tu app de Chat compilada con Apps Script, cambia el número de proyecto de Cloud con el que está asociado el proyecto de Apps Script al número de proyecto que pertenece a tu proyecto nuevo 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 APIs de Google.

Copia el número de tu proyecto de Cloud

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

   Ir a Configuración de IAM y administrador

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

Configura el número de tu 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 Platform (GCP), 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.

Vuelve a configurar y a implementar tu app de Chat

1. En la Consola de APIs de Google, 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: Es una 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 de Chat.

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 la conexión, selecciona Proyecto de Apps Script.

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

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

7. Haz clic en Guardar.

Vuelve a implementar una app de Chat de AppSheet

Para volver a implementar tu app de Chat compilada con AppSheet en tu proyecto nuevo de Cloud, copia la app en el proyecto nuevo 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 Autentícate como una app de Chat.

Comparte tu app de Chat

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

Cambia a la nueva app de Chat

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

Práctica recomendada: Para ayudar a la adopción de la app de Chat migrada, anuncia la migración a tus usuarios y anímales 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 de la persona y, luego, selecciona Apps e integraciones.

4. Haz clic en Agregar apps.

5. Ingresa el nombre de la app, selecciona la app 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.

Quita 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 de la persona y, luego, selecciona Apps e integraciones.

4. Junto a la app de Chat anterior no migrada, 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.

Desactiva la app de Chat anterior

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