# Usar la app de Google de su empresa

> Cree en Google Cloud una app de Google Internal para su empresa y añádala una vez a Trina AX, para que Google Drive, Gmail, Calendar, Docs y Sheets inicien sesión con el nombre de su empresa y sin avisos.

Cuando las personas conectan Google Drive, Gmail, Google Calendar, Google Docs o Google Sheets, inician sesión en Google
a través de la propia app de Google de Trina. Una empresa con Google Workspace puede usar en su lugar **su propia app de
Google**. Su administrador de TI crea la app una vez en Google Cloud y la añade una vez a Trina AX. A partir de entonces,
las cinco apps de Google inician sesión con ella, y las personas ven el nombre de su empresa en la pantalla de Google,
sin el aviso de "app no verificada" y sin límite de cuántas personas pueden iniciar sesión.

Lleva unos 15 minutos: la mayor parte en Google Cloud, y después un cuadro en Trina AX.

> **Consejo:** **Qué necesita**
>
> | Dato | De dónde sale | Adónde va |
> |---|---|---|
> | Dos **direcciones de regreso** | El cuadro de Trina AX, paso **En Google Cloud**, cada una con **Copiar** | Google Cloud › Clients › su cliente › **Authorized redirect URIs** |
> | La lista de **permisos** (scopes) | El bloque de esta página, [Añada los permisos](#en-google-cloud) | Google Cloud › **Data access** › **Manually add scopes** |
> | El **archivo JSON** del cliente (o **ID de cliente** y **Secreto del cliente**) | Google Cloud › **Clients** › **Download JSON**, justo después de crear el cliente | El cuadro de Trina AX, paso **Añádala aquí** |

> **Nota:** Las capturas de esta página usan un equipo inventado, "Acme". No se muestran las pantallas de Google Cloud porque cambian
> a menudo: esta página cita las etiquetas de Google y enlaza con cada página de Google Cloud.

## Para quién es

- **Una empresa con Google Workspace** (todos inician sesión con una dirección de su empresa, como `name@acme.com`).
  Esta página es para usted. Debe ser el propietario del equipo o un administrador en Trina AX, y poder crear un
  proyecto en el Google Cloud de su empresa.
- **Personas con cuentas personales de Gmail.** Mantenga el inicio de sesión de Trina: una app Internal solo deja entrar
  a las cuentas de su propia empresa.

Para los miembros no cambia nada más: las mismas páginas, el mismo botón **Conectar**. Vuelven a conectar Google una
vez, después del cambio.

> **Consejo:** Un equipo pequeño sin Google Workspace puede crear en su lugar una app **External** en **Testing**. Solo pueden iniciar
> sesión las personas que usted añada como usuarios de prueba (100 como máximo), y Google les pide volver a iniciar sesión
> cada 7 días. Para la mayoría de los equipos, el inicio de sesión propio de Trina es más sencillo.

## En Google Cloud

Inicie sesión en [Google Cloud](https://console.cloud.google.com/) con una cuenta de su empresa.

1. **Cree un proyecto**

   Abra [New project](https://console.cloud.google.com/projectcreate). Póngale un nombre que reconozca, como "acme-trina",
   deje su empresa en **Organization** y elija **Create**. Antes de los pasos siguientes, asegúrese de que el proyecto nuevo
   está elegido en la parte superior de la página.

2. **Active cinco API**

   Abra cada una de estas páginas y elija **Enable**:

   - [Google Drive API](https://console.cloud.google.com/apis/library/drive.googleapis.com)
   - [Gmail API](https://console.cloud.google.com/apis/library/gmail.googleapis.com)
   - [Google Calendar API](https://console.cloud.google.com/apis/library/calendar-json.googleapis.com)
   - [Google Docs API](https://console.cloud.google.com/apis/library/docs.googleapis.com)
   - [Google Sheets API](https://console.cloud.google.com/apis/library/sheets.googleapis.com)

   Active las cinco, aunque hoy su equipo use solo algunas de las apps de Google.

3. **Ponga nombre a la app y elija Internal**

   Abra [Google Auth Platform](https://console.cloud.google.com/auth/overview). La primera vez muestra **Get started**:

   1. **App Information**: un **App name** que las personas reconozcan, como "Acme Trina", y un **User support email**.
   2. **Audience**: elija **Internal**. Solo las cuentas de su empresa pueden usar la app, y Google no necesita revisarla.
   3. **Contact Information**: una dirección de correo a la que Google pueda escribir sobre el proyecto.
   4. **Finish**: acepte la política de Google y elija **Create**.

   Más adelante puede cambiar estos datos en [Branding](https://console.cloud.google.com/auth/branding) y
   [Audience](https://console.cloud.google.com/auth/audience).

4. **Añada los permisos**

   Abra [Data access](https://console.cloud.google.com/auth/scopes) y elija **Add or remove scopes**. En **Manually add
   scopes**, pegue el bloque completo de abajo, elija **Add to table**, después **Update** y después **Save**.

   ```
   openid
   https://www.googleapis.com/auth/userinfo.email
   https://www.googleapis.com/auth/userinfo.profile
   https://www.googleapis.com/auth/drive.readonly
   https://www.googleapis.com/auth/drive.file
   https://www.googleapis.com/auth/gmail.readonly
   https://www.googleapis.com/auth/gmail.send
   https://www.googleapis.com/auth/gmail.compose
   https://www.googleapis.com/auth/gmail.modify
   https://www.googleapis.com/auth/gmail.labels
   https://www.googleapis.com/auth/gmail.settings.basic
   https://www.googleapis.com/auth/calendar
   https://www.googleapis.com/auth/calendar.readonly
   https://www.googleapis.com/auth/calendar.events
   https://www.googleapis.com/auth/documents
   https://www.googleapis.com/auth/documents.readonly
   https://www.googleapis.com/auth/spreadsheets
   https://www.googleapis.com/auth/spreadsheets.readonly
   ```

   Son exactamente los permisos que pide Trina AX, para las cinco apps juntas. No omita ninguno: un inicio de sesión al que
   le falte uno se rechaza.

5. **Cree el cliente de inicio de sesión**

   Abra [Clients](https://console.cloud.google.com/auth/clients) y elija **Create client**.

   1. **Application type**: **Web application**.
   2. **Name**: cualquiera, como "Trina AX".
   3. En **Authorized redirect URIs**, elija **Add URI** dos veces y pegue las dos direcciones de regreso. Cópielas de
      Trina AX (el cuadro de la parte siguiente las muestra, cada una con **Copiar**). Tienen este aspecto, con la
      dirección de su equipo:

      ```
      https://<your team address>/api/integrations/google-drive/callback
      https://<your team address>/api/integrations/google-apps/callback
      ```

   4. Elija **Create**. En **OAuth client created**, elija **Download JSON** y guarde el archivo. Google muestra el secreto
      solo en este momento; si lo pierde, cree un secreto nuevo para el cliente.

## En Trina AX

1. **Abra una página de Google**

   En **Administración › Apps conectadas**, elija cualquiera de las apps de Google, **Gmail** por ejemplo. Las cinco páginas
   terminan con **Ajustes del equipo**, y su primera fila es **Inicio de sesión de Google**: "Todos inician sesión con la
   app de Google de Trina. Su empresa puede usar su propia app de Google en su lugar, para todas las apps de Google de
   aquí."

   ![La página de Gmail en Administración › Apps conectadas: Ajustes del equipo con la fila Inicio de sesión de Google (Google sign-in) primero, su texto que dice que todos inician sesión con la app de Google de Trina y el botón Usar la app de su empresa](../../images/google-own-app/row-trina.webp "Ajustes del equipo › Inicio de sesión de Google, con la app de Trina")

2. **Pulse Usar la app de su empresa**

   Se abre el cuadro **Usar la app de Google de su empresa**. Su primer paso, **Antes de empezar**, explica para quién es y
   enlaza con esta página.

   ![El cuadro Usar la app de Google de su empresa, Antes de empezar: para quién es, unos 15 minutos en Google Cloud y un enlace a la guía](../../images/google-own-app/dialog-start.webp "El cuadro, paso 1: Antes de empezar")

3. **En Google Cloud**

   El segundo paso enumera los pasos de Google Cloud de arriba, con un enlace a cada página, y las dos direcciones de
   regreso de su equipo, cada una con **Copiar**. Cópielas desde aquí en **Authorized redirect URIs**, para que queden
   exactas.

   ![El cuadro, En Google Cloud: pasos numerados con un enlace a cada página de Google Cloud y las dos direcciones de regreso del equipo de Acme, cada una con un botón Copiar](../../images/google-own-app/dialog-cloud.webp "El cuadro, paso 2: En Google Cloud")

4. **Añádala aquí**

   Suelte el archivo que descargó de Google, o elíjalo. Si prefiere escribir, **Escribir el ID y el secreto en su lugar**
   abre dos campos para el **ID de cliente** y el **Secreto del cliente**. Un archivo que no incluye las dos direcciones de
   regreso se rechaza, con una línea que indica cuál debe añadir en Google Cloud.

   ![El cuadro, Añádala aquí: el botón para subir el archivo descargado de Google, una línea que dice que también se puede soltar ahí y Escribir el ID y el secreto en su lugar](../../images/google-own-app/dialog-upload.webp "El cuadro, paso 3: Añádala aquí")

5. **Revise y guarde**

   El último paso, **Antes de guardar**, explica qué cambia, con las cifras de su equipo: cuántas personas tendrán que
   volver a conectar Google, y que las cuentas de Google compartidas y los Drive compartidos con el equipo necesitan que un
   administrador los vuelva a conectar. No cambia nada hasta que elija **Guardar**. **Cancelar** lo deja todo como estaba.

   ![El cuadro, Antes de guardar: cuántas personas de Acme tendrán que volver a conectar Google, una línea sobre las cuentas de Google compartidas y los Drive compartidos con el equipo, y los botones Guardar y Cancelar](../../images/google-own-app/dialog-confirm.webp "El cuadro, paso 4: Antes de guardar")

Después de **Guardar**, la fila dice "Todos inician sesión con la app de Google de su empresa, para Google Drive, Gmail,
Calendar, Docs y Sheets." con quién lo configuró y cuándo. Su menú ⋯ tiene **Reemplazar** (para añadir un archivo nuevo,
por ejemplo después de crear un secreto nuevo) y **Volver al inicio de sesión de Google de Trina**. Se configura una sola
vez: la fila es la misma en las cinco páginas de Google.

![La fila Inicio de sesión de Google después de Guardar: todos inician sesión con la app de Google de su empresa, configurado por un administrador de Acme en una fecha, con el menú ⋯ abierto con Reemplazar y Volver al inicio de sesión de Google de Trina](../../images/google-own-app/row-company.webp "Inicio de sesión de Google, con la app de su empresa")

En el teléfono, el ⋯ se queda junto al nombre de la fila, como en los ajustes de un teléfono.

![La fila Inicio de sesión de Google en un teléfono, de 390 píxeles de ancho: el texto sobre la app de Google de su empresa, con el botón ⋯ junto al nombre de la fila](../../images/google-own-app/row-company-phone.webp "Inicio de sesión de Google en un teléfono")

## Lo que ven los miembros

Todas las conexiones con Google hechas a través de la app de Trina dejan de funcionar cuando usted hace el cambio, porque
Google vincula un inicio de sesión a la app que lo hizo.

- **Cada persona** ve su habitual **Volver a conectar** en sus apps de Google en **Configuración › Conectores**, una vez.
  Google muestra entonces el nombre de la app de su empresa, sin aviso.
- **Las cuentas de Google compartidas y los Drive compartidos con el equipo** muestran **Volver a conectar** en
  **Ajustes del equipo** de su página de Google. Un administrador los vuelve a conectar; hasta entonces, la IA no puede
  usarlos.

![La página de Gmail de un miembro en Configuración › Conectores después del cambio, que pide volver a conectar Google con un botón Volver a conectar](../../images/google-own-app/member-reconnect.webp "La página de Gmail de un miembro, que pide volver a conectar")

## Opcional: marcar la app como de confianza en la Admin console

Si su empresa limita qué apps pueden usar las cuentas de Google, un superadministrador de Google Workspace marca la app
como de confianza. En la [Admin console](https://admin.google.com/), abra **Security › Access and data control › API
controls** y después **Manage Third-Party App Access** › **Configure new app**. Busque el ID de cliente (está en el
archivo descargado), elíjalo y marque **Trusted**. Sin esto, las personas pueden ver `admin_policy_enforced` al
conectar.

## Lo que guarda Trina AX

- El ID y el secreto de la app se guardan en **un archivo privado en el servidor de su equipo**, que solo el servidor
  puede leer. Nunca se vuelven a mostrar: ni en la página, ni en un registro, ni en el registro de actividad.
- En un equipo alojado, **el servicio de alojamiento de Trina gestiona ese servidor**, así que también gestiona el lugar donde está ese
  archivo. El secreto por sí solo no abre nada: cada persona sigue iniciando sesión en Google y dando allí su
  consentimiento.
- Los inicios de sesión de Google de cada persona se siguen guardando sellados en el servidor, como antes.

## Volver al inicio de sesión de Trina

En cualquier página de Google, en **Ajustes del equipo › Inicio de sesión de Google**, abra ⋯ y elija **Volver al inicio
de sesión de Google de Trina**. Primero muestra las mismas cifras que **Antes de guardar**. Cuando confirme, las cinco
apps de Google vuelven a iniciar sesión a través de la app de Trina, las personas vuelven a conectar Google una vez y el
archivo de la app de la empresa se borra del servidor. Después puede eliminar el cliente en Google Cloud.

Si cambia la dirección de su equipo, la fila Inicio de sesión de Google lo indica. Añada las dos nuevas direcciones de
regreso al cliente en Google Cloud, descargue su archivo de nuevo y después abra ⋯ › **Reemplazar** en Trina AX: el cuadro
se abre en **En Google Cloud** con las direcciones nuevas para copiar. Hasta entonces, nadie puede conectar Google.

## Problemas

| Qué ve | Qué hacer |
|---|---|
| **`redirect_uri_mismatch`** en la página de Google | Falta una dirección de regreso en Google Cloud o difiere en una letra. Abra [Clients](https://console.cloud.google.com/auth/clients), elija su cliente y pegue de nuevo las dos direcciones desde el paso **En Google Cloud** del cuadro. Lo guardado puede tardar unos minutos en funcionar. |
| **"No se marcaron algunos permisos. Vuelve a conectar y deja todas las casillas marcadas."** | La persona desmarcó una casilla en la pantalla de Google, o falta un permiso en **Data access**. Compruebe que todo el bloque de arriba aparece allí y vuelva a conectar con todas las casillas marcadas. |
| **`admin_policy_enforced`** | La Admin console de su empresa bloquea la app. Márquela como de confianza (vea [más arriba](#opcional-marcar-la-app-como-de-confianza-en-la-admin-console)). |
| Se rechaza **una cuenta de fuera de la empresa** (Google dice que la app solo se puede usar dentro de su organización) | Eso es lo que significa **Internal**. Use una cuenta de su empresa. Las cuentas de Google compartidas también deben ser cuentas de la empresa. |

Todos los detalles para desarrolladores y operadores: [Google apps](https://github.com/trina-app/trina-ax/blob/main/docs/GOOGLE-APPS.md) (en inglés) y
[Google Drive](https://github.com/trina-app/trina-ax/blob/main/docs/GOOGLE-DRIVE.md) (en inglés).
