Gmail
Gmail es un servicio de correo electrónico basado en web de Google. Con el conector de Gmail, puede realizar acciones como enviar o recibir mensajes de correo electrónico y desencadenar flujos en nuevos correos electrónicos.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Estándar | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL |
Compatibilidad con Microsoft LogicApps Soporte técnico de Microsoft Power Automate Soporte técnico de Microsoft Power Apps |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://mail.google.com/mail/ |
| Directiva de privacidad | https://policies.google.com/privacy |
Autenticación y traiga su propia aplicación
El conector de Gmail ahora admite varios tipos de autenticación:
- Uso de la aplicación compartida predeterminada
- Traiga su propia aplicación
La aplicación compartida predeterminada usa una aplicación cliente de Google mantenida por Microsoft. En este caso, al iniciar sesión en su cuenta de Gmail, se le pedirá que dé su consentimiento a la aplicación Microsoft Power Platform .
Con la opción "Traiga su propia aplicación", puede usar su propia aplicación cliente de Google OAuth en lugar de la administrada por Microsoft. Si lo hace, podrá controlar los permisos y habilitar ciertas limitaciones en el uso del conector.
Para usar su propia aplicación cliente de Google OAuth con el conector de Gmail, deberá realizar los pasos siguientes:
- Creación de una aplicación cliente de OAuth mediante la consola de API de Google
- Uso de la aplicación en el conector de Gmail
Creación de una aplicación cliente de OAuth en Google
Para crear su propia aplicación cliente de Google OAuth, primero deberá iniciar sesión en https://developer.google.com. Vaya a la consola de API de Google ( donde puede administrar el acceso a las API de Google) y cree la aplicación OAuth. Este proceso se explica en la Guía para desarrolladores de la API de Gmail de Google. Google proporciona una herramienta de configuración para guiarte a través del proceso de creación de un proyecto para ti, habilitar la API de Gmail para tu proyecto y crear una aplicación cliente de OAuth y las credenciales para él. Esta es una información útil al pasar por la herramienta:
- Lea y acepte los Términos de servicio si es necesario.
- Seleccione un proyecto existente o la herramienta creará una llamada "Mi proyecto".
- La herramienta habilitará la API de Gmail en el proyecto.
- La herramienta intentará averiguar el tipo de credencial que necesita. Deberá obtener una aplicación cliente de OAuth.
- Seleccione Api de Gmail para la API que va a usar (si aún no está seleccionada).
- Seleccione Servidor web para el lugar desde el que llamará a la API.
- Seleccione Datos de usuario para los datos a los que va a acceder.
- La herramienta le guiará a través de la pantalla de configuración de un consentimiento de OAuth.
- Seleccione el tipo de usuario (Interno o Externo). Si usas una cuenta de consumidor de Gmail, no puedes seleccionar Interno.
- Proporcione un nombre y, opcionalmente, un logotipo para la aplicación.
- Haga clic en Agregar ámbito y agregue el ámbito de Gmail (https://mail.google.com).
Nota:
En función de la necesidad de uso, puede seleccionar un subconjunto adecuado de los ámbitos de permisos aquí.
- Agregue azure-apim.net como uno de los dominios autorizados.
Nota:
Este es el dominio en el que se hospeda el conector de Gmail, como se define aquí.
- Opcionalmente, proporcione la otra información.
- La herramienta le permitirá definir y agregar una credencial de cliente de OAuth 2.0.
- Proporcione un nombre para la aplicación cliente de OAuth.
- Agregue "https://global.consent.azure-apim.net/redirect" para el URI de redirección.
Una vez que haya terminado, vaya al cliente de OAuth creado desde la página Credenciales. Encontrará el identificador de cliente y el secreto de cliente de la aplicación. Ahora puedes usar esos valores en tu conexión de Gmail.
Uso de su propia aplicación en el conector de Gmail
Una vez creada la aplicación cliente de Google OAuth, puede usarla al crear una conexión de Gmail.
- Seleccione Bring your own application (Traiga su propia aplicación).
- Especifique los valores id. de cliente y secreto de cliente de la aplicación.
Haga clic en Iniciar sesión para iniciar sesión en su cuenta de Gmail. Esto le pedirá que inicie sesión en su cuenta de Gmail y, a continuación, autorice el acceso a la aplicación de Google que creó anteriormente.
Problemas y limitaciones conocidos
Limitaciones del desencadenador para un gran número de correos electrónicos entrantes
El desencadenador Cuando llega un nuevo correo electrónico puede omitir los correos electrónicos si recibe más de 300 correos electrónicos por intervalo de 30 segundos. Considere la posibilidad de configurar el flujo con parámetros de filtro adicionales para reducir el número de correos electrónicos.
El desencadenador Cuando llega un nuevo correo electrónico puede omitir de forma intermitente correos electrónicos con datos adjuntos si usa una cuenta de Google Workspace (anteriormente G Suite). Esto sucede porque, en algún caso, la API de Gmail tarda mucho tiempo en procesar correos electrónicos (posiblemente debido a exámenes de seguridad de datos adjuntos), por lo que los correos electrónicos se reciben con un retraso determinado.
Como sea posible, pruebe lo siguiente:
Usar correos electrónicos diminutos (sin datos adjuntos), intente enviarlos con tanta frecuencia.
Use otra cuenta de Gmail de consumidor y configure el reenvío automático desde la cuenta de Google Workspace a esta nueva cuenta de Gmail de consumidor. Configure el desencadenador en esta nueva cuenta. Dado que se trata de una cuenta de consumidor, creemos que el retraso se minimizará y el desencadenador no omitirá dichos correos electrónicos.
Use un conector personalizado para ListMessage API con un
qparámetro:Cree una acción para enumerar los mensajes de los últimos 5 minutos. Puede hacerlo mediante
qel parámetro . Ejemplo deqvalor param:after:1649457986. Debe proporcionarcurrent time - 5minla hora de época como entrada de acción.- 1649457986 es la época que representa "Viernes, 8 de abril de 2022 3:46:26 PM GMT-07:00".
Compruebe el valor nextPageToken de la respuesta hasta que esté vacío. Si no está vacío, debe llamar a la misma API con
pageTokenel valor de parámetro establecido en nextPageToken de la respuesta. Puede hacerlo mediante el bucle "Until" por ejemplo.Filtre los identificadores de mensajes que ya se han procesado en ejecuciones anteriores (por ejemplo, puede usar el conector de Azure Table Storage para almacenar identificadores ya procesados).
Usar la acción Obtener detalles del correo electrónico para obtener contenido de correo electrónico por identificador
Uso del conector de Gmail con cuentas de Gmail de consumidor
Conforme a la directiva de privacidad y seguridad de Google, los clientes que usan cuentas de Gmail de consumidor (cuentas que terminan en @gmail.com y @googlemail.com) solo pueden conectarse a un conjunto limitado de servicios dentro de Power Automate y Logic Apps. Los clientes que usan cuentas de Google Workspace (anteriormente G Suite) no se ven afectados por este cambio. Si necesita usar el conector de Gmail con servicios no especificados en la lista siguiente, deberá registrar su propio identificador de aplicación con Google. A continuación se muestra la lista de los servicios aprobados actuales, tenga en cuenta que esta lista está sujeta a cambios en el futuro de acuerdo con las directivas de Google:
- Servicios de Google: Gmail, Google Calendar, Google Contacts, Google Drive, Google Sheets, Google Tasks
- Acciones y desencadenadores integrados: Control, AI Builder, operaciones de datos, Fecha y hora, Funciones de número, Power Virtual Agents, Power Apps, Solicitud, Programación, Funciones de texto, Variables, botón Flujo, Ubicación
- Conjunto limitado de servicios de Microsoft: OneDrive, Sharepoint, Excel, Dynamics, Microsoft Teams, Office 365, SQL, SFTP y FTP
En Power Automate si crea un flujo con un servicio no compatible, el flujo terminará guardándose en un estado deshabilitado.
Cálculo de unidades de trabajo
El conector tiene un límite de limitación (consulte aquí) en el número de unidades de trabajo que se pueden consumir en un día.
A continuación se muestra la lógica sobre cómo se calculan estas unidades de trabajo para cada operación:
-
Cuando llega un nuevo correo electrónico : 10 + (5 * datos adjuntosCount);
- Si el desencadenador devuelve un nuevo correo electrónico: 5 unidades para enumerar mensajes + 5 unidades para obtener el mensaje + 5 unidades * recuento de datos adjuntos.
- Si el desencadenador no devuelve nuevo correo electrónico: 5 unidades para enumerar mensajes.
- Acción Enviar correo electrónico (V2): 100 unidades.
-
Acción responder al correo electrónico (V2): 105 + (5 * attachmentsCount);
- 5 unidades para obtener el mensaje original + 100 unidades para enviar el mensaje de respuesta + 5 unidades * recuento de datos adjuntos insertados en el mensaje original.
- Para todas las demás acciones: 10 unidades.
Conector en profundidad
Para más información sobre el conector, consulte la sección en profundidad.
Límites generales
| Nombre | Importancia |
|---|---|
| Tamaño máximo de correo (en MB) | 35 |
| Tamaño máximo de datos adjuntos (en MB) | 30 |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Traiga su propia aplicación | Inicie sesión con su propia aplicación de Google. Para obtener más información, consulte https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application. | Todas las regiones | No se puede compartir |
| Uso de la aplicación compartida predeterminada | Inicie sesión con la aplicación estándar de Google. | Todas las regiones | No se puede compartir |
| Valor predeterminado [EN DESUSO] | Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores. | Todas las regiones | No se puede compartir |
Traiga su propia aplicación
Identificador de autenticación: byoa
Aplicable: Todas las regiones
Inicie sesión con su propia aplicación de Google. Para obtener más información, consulte https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Id. de cliente | cuerda / cadena | Id. de cliente (o aplicación) de la aplicación de Google | Cierto |
| Secreto del cliente | securestring | Secreto de cliente de la aplicación de Google | Cierto |
Uso de la aplicación compartida predeterminada
Identificador de autenticación: aplicación compartida
Aplicable: Todas las regiones
Inicie sesión con la aplicación estándar de Google.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
Valor predeterminado [EN DESUSO]
Aplicable: Todas las regiones
Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 60 | 60 segundos |
| Unidades de trabajo por día | 90000 | 86400 segundos |
Acciones
| Eliminar correo electrónico |
Esta operación se usa para eliminar permanentemente un correo electrónico específico. |
| Enviar correo electrónico (V2) |
Esta operación se usa para enviar un correo electrónico a destinatarios específicos. |
| Enviar correo electrónico [EN DESUSO] |
Esta acción ha quedado en desuso. Use Enviar correo electrónico (V2) en su lugar.
|
| Mover correo electrónico a la papelera |
Esta operación se usa para mover un correo electrónico específico a la papelera. |
| Obtención de detalles de correo electrónico |
Esta operación recupera los detalles de un correo electrónico específico. |
| Responder al correo electrónico (V2) |
Esta operación se usa para responder a un correo electrónico específico. |
| Responder al correo electrónico [EN DESUSO] |
Esta acción ha quedado en desuso. Use responder al correo electrónico (V2) en su lugar.
|
Eliminar correo electrónico
Esta operación se usa para eliminar permanentemente un correo electrónico específico.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de mensaje
|
id | True | string |
Identificador del correo electrónico que se va a eliminar. |
Enviar correo electrónico (V2)
Esta operación se usa para enviar un correo electrónico a destinatarios específicos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Para
|
To | True |
Lista de direcciones de correo electrónico válidas separadas por punto y coma o coma. |
|
|
CC
|
Cc |
Lista de direcciones de correo electrónico válidas separadas por punto y coma o coma. |
||
|
BCC
|
Bcc |
Lista de direcciones de correo electrónico válidas separadas por punto y coma o coma. |
||
|
Asunto
|
Subject | string |
Asunto del correo electrónico saliente. |
|
|
Body
|
Body | html |
Cuerpo del correo electrónico saliente. |
|
|
Importancia
|
Importance | string |
Importancia asociada al mensaje de correo electrónico. |
|
|
Nombre
|
Name | True | string |
Título de los datos adjuntos. |
|
Content
|
ContentBytes | True | byte |
Cuerpo de los datos adjuntos. |
|
Tipo de contenido
|
ContentType | string |
Tipo de contenido en los datos adjuntos. |
Enviar correo electrónico [EN DESUSO]
Esta acción ha quedado en desuso. Use Enviar correo electrónico (V2) en su lugar.
Esta operación se usa para enviar un correo electrónico a destinatarios específicos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Para
|
To | True |
Lista de direcciones de correo electrónico válidas separadas por punto y coma o coma. |
|
|
CC
|
Cc |
Lista de direcciones de correo electrónico válidas separadas por punto y coma o coma. |
||
|
BCC
|
Bcc |
Lista de direcciones de correo electrónico válidas separadas por punto y coma o coma. |
||
|
Asunto
|
Subject | string |
Asunto del correo electrónico saliente. |
|
|
Body
|
Body | string |
Cuerpo del correo electrónico saliente. |
|
|
Es HTML
|
IsHtml | boolean |
True para enviar el correo electrónico como HTML. (valor predeterminado: True) |
|
|
Importancia
|
Importance | string |
Importancia asociada al mensaje de correo electrónico. |
|
|
Nombre
|
Name | True | string |
Título de los datos adjuntos. |
|
Content
|
ContentBytes | True | byte |
Cuerpo de los datos adjuntos. |
|
Tipo de contenido
|
ContentType | string |
Tipo de contenido en los datos adjuntos. |
Mover correo electrónico a la papelera
Esta operación se usa para mover un correo electrónico específico a la papelera.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de mensaje
|
id | True | string |
Id. del correo electrónico que se va a mover a la papelera. |
Obtención de detalles de correo electrónico
Esta operación recupera los detalles de un correo electrónico específico.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de mensaje
|
id | True | string |
Identificador único del mensaje de correo electrónico. |
|
Incluir datos adjuntos
|
includeAttachments | boolean |
Si se establece en true, los datos adjuntos también se recuperarán junto con el correo electrónico. |
Devoluciones
Detalles asociados a un mensaje de correo electrónico específico.
Responder al correo electrónico (V2)
Esta operación se usa para responder a un correo electrónico específico.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de mensaje
|
id | True | string |
Identificador del correo electrónico al que responder. |
|
Para
|
To |
Ejemplo: recipient1@domain.com; recipient2@domain.com |
||
|
CC
|
Cc |
Ejemplo: recipient1@domain.com; recipient2@domain.com |
||
|
BCC
|
Bcc |
Ejemplo: recipient1@domain.com; recipient2@domain.com |
||
|
Asunto
|
Subject | string |
Asunto del correo electrónico (si está vacío, se usa el asunto original). |
|
|
Body
|
Body | html |
Contenido del correo electrónico. |
|
|
Responder todo
|
ReplyAll | boolean |
True para responder a todos los destinatarios. (valor predeterminado: False) |
|
|
Importancia
|
Importance | string |
Elija una importancia. (valor predeterminado: Normal) |
|
|
Nombre
|
Name | True | string |
Título de los datos adjuntos. |
|
Content
|
ContentBytes | True | byte |
Cuerpo de los datos adjuntos. |
|
Tipo de contenido
|
ContentType | string |
Tipo de contenido en los datos adjuntos. |
Responder al correo electrónico [EN DESUSO]
Esta acción ha quedado en desuso. Use responder al correo electrónico (V2) en su lugar.
Esta operación se usa para responder a un correo electrónico específico.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de mensaje
|
id | True | string |
Identificador del correo electrónico al que responder. |
|
Para
|
To |
Ejemplo: recipient1@domain.com; recipient2@domain.com |
||
|
CC
|
Cc |
Ejemplo: recipient1@domain.com; recipient2@domain.com |
||
|
BCC
|
Bcc |
Ejemplo: recipient1@domain.com; recipient2@domain.com |
||
|
Asunto
|
Subject | string |
Asunto del correo electrónico (si está vacío, se usa el asunto original). |
|
|
Body
|
Body | string |
Contenido del correo electrónico. |
|
|
Responder todo
|
ReplyAll | boolean |
True para responder a todos los destinatarios. (valor predeterminado: False) |
|
|
Es HTML
|
IsHtml | boolean |
True para enviar la respuesta como HTML. (valor predeterminado: True) |
|
|
Importancia
|
Importance | string |
Elija una importancia. (valor predeterminado: Normal) |
|
|
Nombre
|
Name | True | string |
Título de los datos adjuntos. |
|
Content
|
ContentBytes | True | byte |
Cuerpo de los datos adjuntos. |
|
Tipo de contenido
|
ContentType | string |
Tipo de contenido en los datos adjuntos. |
Desencadenadores
| Cuando llega un nuevo correo electrónico |
Esta operación se desencadena cuando llega un nuevo correo electrónico que coincida con los criterios especificados. |
Cuando llega un nuevo correo electrónico
Esta operación se desencadena cuando llega un nuevo correo electrónico que coincida con los criterios especificados.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Etiqueta
|
label | string |
Elija una etiqueta (valor predeterminado: Bandeja de entrada). |
|
|
Para
|
to |
Lista de direcciones de correo electrónico válidas separadas por punto y coma o coma. |
||
|
De
|
from |
Ejemplo: Sender1 | sender2@domain.com. |
||
|
Asunto
|
subject | string |
Cadena que se va a buscar en el asunto. |
|
|
Importancia
|
importance | string |
True si el correo electrónico debe ser importante. (valor predeterminado: All). |
|
|
Estrellado
|
starred | string |
True si el correo electrónico debe estar protagonizado. (valor predeterminado: All). |
|
|
Con adjuntos
|
fetchOnlyWithAttachments | boolean |
True para recuperar solo correos electrónicos con datos adjuntos. |
|
|
Incluir datos adjuntos
|
includeAttachments | boolean |
True para recuperar datos adjuntos junto con el correo electrónico. |
Devoluciones
Detalles asociados a un mensaje de correo electrónico específico.
Definiciones
DetailedReceiveMessage
Detalles asociados a un mensaje de correo electrónico específico.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
De
|
From |
Dirección de correo electrónico desde la que se envió el mensaje. |
|
|
Nombre del remitente
|
SenderName | string |
Nombre del remitente del correo electrónico |
|
Para
|
To |
Dirección de correo electrónico a la que se envió el mensaje. |
|
|
CC
|
Cc |
Direcciones de correo electrónico contenidas en el campo CC. |
|
|
BCC
|
Bcc |
Direcciones de correo electrónico contenidas en el campo BCC. |
|
|
Asunto
|
Subject | string |
Asunto o tema asociado al mensaje de correo electrónico. |
|
Body
|
Body | string |
Contenido del mensaje de correo electrónico. |
|
Fragmento
|
Snippet | string |
Parte corta del texto del mensaje. |
|
Identificadores de etiqueta
|
LabelIds | array of string |
Lista de etiquetas asociadas al mensaje de correo electrónico. |
|
Date-Time recibidos
|
DateTimeReceived | date-time |
Ejemplo:2017-05-03T20:08:57+00:00 |
|
Tamaño estimado
|
EstimatedSize | integer |
Tamaño estimado en bytes del mensaje. |
|
¿Es leído?
|
IsRead | boolean |
True si se lee el mensaje; False en caso contrario. |
|
Es HTML
|
IsHtml | boolean |
True si el mensaje está en formato HTML. |
|
Con adjuntos
|
HasAttachments | boolean |
True si el mensaje tiene datos adjuntos. |
|
Attachments
|
Attachments | array of Attachment |
Lista de datos adjuntos al mensaje de correo electrónico. |
|
Id. de mensaje
|
Id | string |
Identificador inmutable del mensaje. |
|
Identificador de subproceso
|
ThreadId | string |
Identificador del subproceso al que pertenece el mensaje. |
Attachment
Propiedades de un archivo adjunto de correo electrónico.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre
|
Name | string |
Título de los datos adjuntos. |
|
Content
|
ContentBytes | byte |
Cuerpo de los datos adjuntos. |
|
Tipo de contenido
|
ContentType | string |
Tipo de contenido en los datos adjuntos. |