Para que el asistente pueda leer el correo en Google Workspace y crear borradores en él, necesita acceso a través de la Gmail API. Para ello, la organización crea algo en su propio Google Cloud; draften no tiene una aplicación común a la que usted solo dé su consentimiento. Esto vale tanto para nuestro servicio como para una instalación en su propio servidor.
Todo lo que se describe aquí vale solo para cuentas de Google Workspace con dominio propio. Con una cuenta personal @gmail.com no se puede iniciar sesión en draften; un Gmail personal sí se puede conectar por IMAP con una contraseña de aplicación: consulte Proveedores compatibles y límites.
Qué quiere y qué configurar
| Qué quiere | Qué configurar |
|---|---|
| Los miembros inician sesión con su cuenta de Google y cada uno tiene su propio buzón | el cliente de la organización; con eso basta |
| Además, buzones en los que nadie inicia sesión (por ejemplo, info@) o un acceso a los buzones configurado de forma centralizada, sin sus propietarios | además, el registro de la organización (cuenta de servicio) |
| No quiere el inicio de sesión con cuenta de Google | las personas inician sesión con la contraseña de la invitación y el correo lo conecta el registro de la organización (o IMAP) |
Dos cosas distintas en Google
El cliente de la organización y el registro de la organización son dos cosas independientes en Google Cloud. Cada una hace algo distinto y una no sustituye a la otra:
| Cliente de la organización | Registro de la organización | |
|---|---|---|
| Qué es | un cliente OAuth con una pantalla de consentimiento de tipo Internal | una cuenta de servicio con clave y domain-wide delegation |
| Qué hace | el inicio de sesión de los miembros con el botón Iniciar sesión con Google y el botón Conectar Gmail en el buzón propio | el acceso del asistente a los buzones sin que sus propietarios inicien sesión |
| Dónde en draften | Organización › Inicio de sesión y acceso al correo › tarjeta Inicio de sesión con cuenta y conexión de buzones | Organización › Inicio de sesión y acceso al correo › tarjeta Registros para buzones compartidos y gestión central |
| Quién lo configura en draften | el propietario de la organización | el propietario o un administrador de la organización |
| Quién lo crea en Google | el administrador de Google Cloud | el administrador de Google Cloud y un superadministrador de Google Admin |
| Quién inicia sesión en el buzón | el propietario de cada buzón, una vez | nadie |
| A qué buzones llega | solo a los que las personas conectan ellas mismas | a todos los buzones del dominio |
Son dos cosas a propósito. El consentimiento para el cliente da derechos solo sobre los buzones que las personas conectan ellas mismas, nunca sobre el correo de todo el dominio. La cuenta de servicio, en cambio, llega a cualquier buzón del dominio, y por eso draften solo la usa para el acceso a los buzones, no para el inicio de sesión. No los junte.
Cada buzón usa uno de los dos accesos; puede tener ambos a la vez. draften solo pide el ámbito gmail.modify: leer y crear borradores; no envía nada.
Cliente de la organización: inicio de sesión y Conectar Gmail
El propietario del buzón inicia sesión con su cuenta de Google y permite el acceso solo a su propio correo. El mismo cliente sirve también para iniciar sesión en draften con una cuenta de Google.
En Google Cloud
Trabaja en https://console.cloud.google.com, con la sesión iniciada con una cuenta de administrador de su dominio de Workspace. Todo ocurre en un solo proyecto: el proyecto seleccionado se ve arriba a la izquierda, junto al logotipo de Google Cloud; allí también puede cambiarlo o crear uno nuevo. El menú principal se abre con el icono ☰ arriba a la izquierda.
- Primero abra en draften Organización › Inicio de sesión y acceso al correo, la tarjeta Inicio de sesión con cuenta y conexión de buzones. Muestra dos redirect URI exactos para la dirección de su draften: terminan en
/auth/google/callbacky/mailboxes/connect/google/callback. Cópielos de allí; deben coincidir carácter por carácter. - Elija un proyecto o cree uno nuevo (por ejemplo,
draften) y habilite en él la Gmail API: ☰ → APIs & Services → Library, busque Gmail API, ábrala y haga clic en Enable. Directamente: https://console.cloud.google.com/apis/library/gmail.googleapis.com - Configure cómo se presenta la aplicación a los usuarios (consent screen): ☰ → APIs & Services → OAuth consent screen. Se abre la página Google Auth Platform; directamente: https://console.cloud.google.com/auth/overview (compruebe que arriba está seleccionado el proyecto correcto). Haga clic en Get started y recorra el asistente:
- App Information: App name
drafteny User support email (su correo electrónico o un grupo de administradores). Next. - Audience: elija Internal. Así solo puede iniciar sesión una cuenta de su dominio de Workspace y Google no tiene que verificar la aplicación. Next.
- Contact Information: el correo electrónico al que Google le enviará avisos sobre la aplicación. Next.
- Finish: marque la casilla de aceptación de las políticas de Google (I agree to the Google API Services: User Data Policy), haga clic en Continue y después en Create.
- App Information: App name
- Permita los ámbitos a la aplicación. En Google Auth Platform, en el menú de la izquierda, abra Data Access (directamente: https://console.cloud.google.com/auth/scopes) → Add or remove scopes. En la lista, marque
openid,.../auth/userinfo.emaily.../auth/userinfo.profile. El ámbito de Gmail péguelo en el campo Manually add scopes:https://www.googleapis.com/auth/gmail.modify→ Add to table. Haga clic en Update y, abajo, en Save. - Cree el cliente. En Google Auth Platform, en el menú de la izquierda, abra Clients (directamente: https://console.cloud.google.com/auth/clients) → Create client. Application type: Web application, con un nombre, por ejemplo
draften. En Authorized redirect URIs, haga clic en Add URI y pegue la primera dirección de la tarjeta; después, otra vez Add URI y la segunda. Haga clic en Create. - Se muestran el Client ID y el Client secret: copie ambos enseguida. Google no vuelve a mostrar el Client secret; si lo pierde, cree uno nuevo en el cliente.
En draften
- El propietario de la organización abre Organización › Inicio de sesión y acceso al correo y, en la tarjeta Inicio de sesión con cuenta y conexión de buzones, rellena en Cliente OAuth de Google los valores Client ID y Client secret del paso 6 y hace clic en Guardar.
- El inicio de sesión con cuenta de Google lo activa en la misma página, en la tarjeta Cómo inician sesión los miembros: en Dominios de correo de la organización escribe su dominio de Workspace, el principal, no un alias (Google no lo envía al iniciar sesión). En cuanto la organización tiene el cliente y el dominio, los miembros inician sesión con su cuenta de Google y sus contraseñas dejan de funcionar: consulte Cómo inician sesión los miembros.
- El propietario del buzón abre la página del buzón y, en la tarjeta Acceso al correo, en la fila Conectar con la cuenta del buzón:, hace clic en Conectar Gmail. Inicia sesión con la cuenta de ese buzón (draften rechaza cualquier otra cuenta) y permite el acceso. El botón solo lo ve el propietario del buzón, y solo si la organización tiene el cliente; sin él, la tarjeta indica en lugar del botón que la conexión con la cuenta será posible cuando el propietario de la organización añada el cliente.
- Después, Probar la conexión.
Cuando un buzón se desconecta
- La cuenta se eliminó o se bloqueó, o se revocó el acceso: Google deja de emitir tokens y draften desconecta el buzón. Vuelva a conectarlo (Volver a conectar Gmail) o conéctelo con el registro de la organización (más abajo).
- «El proveedor no emitió ningún token de actualización»: el propietario del buzón quita la aplicación en la configuración de su cuenta de Google (Seguridad → Aplicaciones de terceros) y vuelve a conectar el buzón.
- «Inició sesión una cuenta distinta de la dirección del buzón»: al conectar, elija la cuenta de ese mismo buzón.
Registro de la organización: acceso sin inicio de sesión
Una cuenta de servicio con domain-wide delegation da al asistente acceso a los buzones del dominio sin que nadie inicie sesión. Sirve para buzones en los que nadie inicia sesión (por ejemplo, info@) y para organizaciones que quieren administrar el acceso de forma centralizada. No tiene nada que ver con el inicio de sesión en draften.
En Google Cloud
Trabaja en https://console.cloud.google.com, en el mismo proyecto en el que está habilitada la Gmail API (paso 2 del cliente de la organización; sin cliente, habilítela igualmente). Compruebe el proyecto arriba a la izquierda, junto al logotipo de Google Cloud.
- Abra la lista de cuentas de servicio: ☰ → IAM & Admin → Service accounts. Directamente: https://console.cloud.google.com/iam-admin/serviceaccounts
- Arriba, haga clic en + Create service account y recorra los tres pasos:
- Service account details: Service account name, por ejemplo
draften-correo(el ID se completa solo). Haga clic en Create and continue. - Permissions (optional): no elija nada; no necesita ningún rol en el proyecto, el acceso al correo se lo da la delegación en Google Admin. Haga clic en Continue.
- Principals with access (optional): no rellene nada y haga clic en Done.
- Service account details: Service account name, por ejemplo
- En la lista, haga clic en la nueva cuenta de servicio. En la pestaña Details, copie el Unique ID, un número largo: es el Client ID para Google Admin.
- Pestaña Keys → Add key → Create new key → Key type: JSON → Create. El navegador descarga un archivo con la clave (
….json).
Si Google rechaza crear la clave, su organización tiene activada la política Disable service account key creation (iam.disableServiceAccountKeyCreation; las organizaciones nuevas la tienen activada de forma predeterminada). El administrador de la organización la desactiva para este proyecto: ☰ → IAM & Admin → Organization policies (https://console.cloud.google.com/iam-admin/orgpolicies), busca iam.disableServiceAccountKeyCreation → Manage policy → Override parent's policy → Enforcement: Off → Set policy. Después, repita el paso 4.
En Google Admin
Necesita una cuenta de superadministrador de Google Workspace.
- Abra https://admin.google.com → en el menú de la izquierda, Security → Access and data control → API controls → abajo, Domain wide delegation → Manage domain wide delegation. Directamente: https://admin.google.com/ac/owl/domainwidedelegation
- Haga clic en Add new y rellene:
- Client ID: el Unique ID numérico del paso 3,
- OAuth scopes (comma-delimited):
https://www.googleapis.com/auth/gmail.modify.
Haga clic en Authorize. La delegación aparece en la lista. Suele aplicarse en pocos minutos y, en casos excepcionales, tarda varias horas.
En draften
- Abra Organización › Inicio de sesión y acceso al correo, la tarjeta Registros para buzones compartidos y gestión central. Los registros los administran el propietario o los administradores de la organización.
- Sistema: Google Workspace. Rellene Nombre, elija el archivo descargado en Clave de la cuenta de servicio (JSON) y haga clic en Añadir registro. La clave se guarda cifrada; en la tarjeta solo se ven después el correo electrónico de la cuenta de servicio y su Client ID.
- En la página de cada buzón, en la tarjeta Acceso al correo, elija este registro en Registro de la organización, haga clic en Aplicar y después en Probar la conexión. El procedimiento con capturas lo muestra la guía «Añadir y conectar un buzón».
Después, elimine el archivo descargado con la clave. Quien lo tenga entra en cualquier buzón del dominio. Una clave nueva de la misma cuenta de servicio (paso 4 de arriba) se sube en el registro con la opción nueva clave (JSON); la clave de otra cuenta de servicio añádala como un registro nuevo. Después, elimine la clave antigua en Google Cloud: cuenta de servicio → pestaña Keys → icono de la papelera junto a la clave antigua.
Con el buzón automático activado (Cómo inician sesión los miembros), un buzón nuevo se vincula solo al registro cuando hay exactamente uno activo para Google Workspace.
Errores de la prueba de la conexión
La prueba comprueba tres pasos: Acceso, Token y permiso y Lectura de la Bandeja de entrada.
| En el mensaje | Qué significa | Qué hacer |
|---|---|---|
la delegación para el ámbito no está autorizada (unauthorized_client) | en Google Admin falta la domain-wide delegation, o tiene otro Client ID u otro ámbito | revisar la delegación en Google Admin: el ID numérico y el ámbito exacto gmail.modify |
invalid_grant con la cuenta de servicio | ese buzón no existe en el dominio de Workspace | comprobar la dirección del buzón |
| «Gmail API has not been used…» | la Gmail API no está habilitada en el proyecto | habilitar la Gmail API |
token sin gmail.modify | la delegación o la pantalla de consentimiento no tiene el ámbito gmail.modify | añadir el ámbito |
invalid_grant, deleted_client con una cuenta conectada | la conexión se revocó o se eliminó el cliente | Volver a conectar Gmail |
Otros errores se describen en Solución de problemas.