Partilhar via

Gmail

O Gmail é um serviço de e-mail baseado na Web da Google. Com o conector do Gmail, você pode executar ações como enviar ou receber mensagens de e-mail e acionar fluxos em novos e-mails.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Standard Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Microsoft
URL Suporte do Microsoft LogicApps
Suporte do Microsoft Power Automate
Suporte do Microsoft Power Apps
Metadados do conector
Editora Microsoft
Sítio Web https://mail.google.com/mail/
Política de privacidade https://policies.google.com/privacy

Autenticação e traga seu próprio aplicativo

O conector do Gmail agora é compatível com vários tipos de autenticação:

  • Usar aplicativo compartilhado padrão
  • Traga a sua própria candidatura

O aplicativo compartilhado padrão usa um aplicativo cliente do Google mantido pela Microsoft. Neste caso, quando iniciar sessão na sua conta do Gmail, ser-lhe-á pedido que dê o seu consentimento para a aplicação Microsoft Power Platform .

Com a opção "Traga seu próprio aplicativo", você pode usar seu próprio aplicativo Google OAuth Client em vez do gerenciado pela Microsoft. Isso permitirá que você controle permissões e habilite certas limitações no uso do conector.

Para usar seu próprio aplicativo Google OAuth Client com o conector do Gmail, você precisará executar as seguintes etapas:

  1. Criar um aplicativo cliente OAuth usando o Console de API do Google
  2. Use o aplicativo no conector do Gmail

Criando um aplicativo cliente OAuth no Google

Para criar seu próprio aplicativo cliente Google OAuth, você precisará primeiro fazer login no https://developer.google.com. Navegue até o Console de API do Google, que é onde você pode gerenciar o acesso às APIs do Google, e crie o aplicativo OAuth. Esse processo é explicado no Guia do desenvolvedor da API do Gmail do Google. O Google fornece uma ferramenta de configuração para guiá-lo pelo processo de criação de um projeto para você, ativar a API do Gmail para seu projeto e criar um aplicativo cliente OAuth e as credenciais para ele. Aqui estão algumas informações que você achará úteis ao passar pela ferramenta:

  • Leia e concorde com os Termos de Serviço, se necessário.
  • Selecione um projeto existente ou a ferramenta criará um novo chamado "Meu projeto".
  • A ferramenta habilitará a API do Gmail no projeto.
  • A ferramenta tentará descobrir o tipo de credencial que você precisa. Você precisará obter um aplicativo OAuth Client.
    • Selecione a API do Gmail para a API que você usará (se ainda não estiver selecionada).
    • Selecione Servidor Web para o local de onde você chamará a API.
    • Selecione Dados do usuário para os dados que você acessará.
  • A ferramenta irá guiá-lo através da configuração de uma tela de consentimento OAuth.
    • Selecione o tipo de usuário (Interno ou Externo). Se você estiver usando uma conta de consumidor do Gmail, não poderá selecionar Interna.
    • Forneça um nome e, opcionalmente, um logotipo para seu aplicativo.
    • Clique em Adicionar escopo e adicione o escopo do Gmail (https://mail.google.com).

      Observação

      Com base na sua necessidade de uso, você pode selecionar um subconjunto apropriado dos escopos de permissão aqui.

    • Adicione azure-apim.net como um dos domínios autorizados.

      Observação

      Este é o domínio no qual o conector do Gmail está hospedado, conforme definido aqui.

    • Opcionalmente, forneça as outras informações.
  • A ferramenta permitirá que você defina e adicione uma credencial de cliente OAuth 2.0.
    • Forneça um nome para seu aplicativo OAuth Client.
    • Adicionar "https://global.consent.azure-apim.net/redirect" para o URI de redirecionamento.

Quando terminar, navegue até o cliente OAuth criado na página Credenciais. Você encontrará a ID do Cliente e o segredo do Cliente do seu aplicativo. Agora você pode usar esses valores em sua conexão do Gmail.

Cliente Google OAuth

Utilizar a sua própria aplicação no conector do Gmail

Depois de criar o aplicativo cliente Google OAuth, você pode usá-lo ao criar uma conexão com o Gmail.

  • Selecione Traga seu próprio aplicativo.
  • Especifique os valores de ID do Cliente e Segredo do Cliente do seu aplicativo.

Clique em Iniciar sessão para iniciar sessão na sua conta do Gmail. Isso solicitará que você faça login na sua conta do Gmail e, em seguida, autorize o acesso ao aplicativo do Google que você criou acima.

Problemas conhecidos e limitações

Limitações de gatilho para um grande número de e-mails recebidos

O gatilho Quando um novo e-mail chega pode ignorar e-mails se você estiver recebendo mais de 300 e-mails por intervalo de 30 segundos. Considere configurar seu fluxo com parâmetros de filtro adicionais para reduzir o número de e-mails.

O gatilho Quando um novo e-mail chega pode ignorar intermitentemente e-mails com anexos se você estiver usando uma conta do Google Workspace (anteriormente G Suite). Isso acontece porque, em alguns casos, a API do Gmail leva muito tempo para processar e-mails (possivelmente devido a verificações de segurança de anexos), então os e-mails são recebidos com um certo atraso.

Como possível solução alternativa, tente o seguinte:

  • Use e-mails minúsculos (sem anexos), tente enviá-los com pouca frequência

  • Use outra conta do Gmail de consumidor e configure o encaminhamento automático da conta do Google Workspace para essa nova conta do Gmail de consumidor. Configure o gatilho contra essa nova conta. Uma vez que esta é uma conta de consumidor, acreditamos que o atraso será minimizado e o gatilho não irá ignorar tais e-mails.

  • Use um conector personalizado para ListMessage API com um q parâmetro:

    • Crie uma ação para listar mensagens dos últimos 5 minutos. Você pode fazer isso usando q o parâmetro. Exemplo de valor de q param - after:1649457986. Você deve fornecer current time - 5min o tempo de época como entrada de ação.

      • 1649457986 é a época que representa "Sexta-feira, 8 de abril de 2022 15:46:26 GMT-07:00".

    • Verifique o valor nextPageToken da resposta até que ela esteja vazia. Se não estiver vazio, você precisará chamar a mesma API com pageToken o valor do parâmetro definido para o nextPageToken a partir da resposta. Você pode fazer isso usando o loop "Até", por exemplo.

    • Filtre as IDs de mensagens que já foram processadas em execuções anteriores (por exemplo, você pode usar o conector do Armazenamento de Tabela do Azure para armazenar IDs já processadas)

    • Use a ação Obter detalhes de e-mail para obter conteúdo de e-mail por ID

Como usar o conector do Gmail com contas de consumidor do Gmail

Em conformidade com a política de segurança e privacidade da Google, os clientes que utilizam contas de consumidor do Gmail (Contas que terminam em @gmail.com e @googlemail.com) só podem ligar-se a um conjunto limitado de serviços nas Power Automate e nas Aplicações lógicas. Os clientes que utilizam contas do Google Workspace (anteriormente G Suite) não são afetados por esta alteração. Se você precisar usar o conector do Gmail com serviços não especificados na lista abaixo, você precisará registrar seu próprio ID de aplicativo no Google. Abaixo está a lista dos serviços aprovados atualmente, observe que esta lista está sujeita a alterações no futuro, de acordo com as políticas do Google:

  • Serviços Google: Gmail, Google Agenda, Contactos Google, Google Drive, Folhas de cálculo do Google, Google Tarefas
  • Ações e gatilhos integrados: Controle, AI Builder, Operações de dados, Data e hora, Funções numéricas, Power Virtual Agents, Power Apps, Solicitação, Programação, Funções de texto, Variáveis, botão Fluxo, Localização
  • Conjunto limitado de serviços Microsoft: OneDrive, Sharepoint, Excel, Dynamics, Microsoft Teams, Office 365, SQL, SFTP e FTP

No Power Automate, se você criar um fluxo com um serviço não compatível, o fluxo acabará sendo salvo em um estado desativado.

Cálculo de unidades de trabalho

O conector tem um limite de limitação (consulte aqui) no número de unidades de trabalho que podem ser consumidas em um dia.

A lógica sobre como essas unidades de trabalho são calculadas para cada operação é mostrada abaixo:

  • Quando um novo e-mail chega gatilho : 10 + (5 * attachmentsCount);
    • Se o gatilho retornar novo e-mail: 5 unidades para listar mensagens + 5 unidades para receber mensagem + 5 unidades * contagem de anexos.
    • Se o gatilho não retornar novo e-mail: 5 unidades para listar mensagens.
  • Enviar e-mail (V2) ação: 100 unidades.
  • Responder ao e-mail (V2) ação: 105 + (5 * attachmentsCount);
    • 5 unidades para obter a mensagem original + 100 unidades para enviar a mensagem de resposta + 5 unidades * os anexos embutidos contam na mensagem original.
  • Para todas as outras ações: 10 unidades.

Conector em profundidade

Para obter mais informações sobre o conector, consulte a seção detalhada.

Limites Gerais

Nome Valor
Tamanho máximo do correio (em MB) 35
Tamanho máximo do anexo (em MB) 30

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Traga a sua própria candidatura Faça login usando seu próprio aplicativo do Google. Para obter mais detalhes, veja https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application. Todas as regiões Não compartilhável
Usar aplicativo compartilhado padrão Faça login usando o aplicativo padrão do Google. Todas as regiões Não compartilhável
Padrão [DEPRECATED] Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. Todas as regiões Não compartilhável

Traga a sua própria candidatura

ID da autenticação: byoa

Aplicável: Todas as regiões

Faça login usando seu próprio aplicativo do Google. Para obter mais detalhes, veja https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
ID do Cliente cadeia (de caracteres) ID do cliente (ou aplicativo) do seu aplicativo do Google Verdade
Segredo do Cliente securestring Segredo do cliente da sua aplicação Google Verdade

Usar aplicativo compartilhado padrão

Auth ID: aplicativo compartilhado

Aplicável: Todas as regiões

Faça login usando o aplicativo padrão do Google.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Padrão [DEPRECATED]

Aplicável: Todas as regiões

Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 60 60 segundos
Unidades de trabalho por dia 90000 86400 segundos

Ações

Enviar e-mail (V2)

Esta operação é usada para enviar um e-mail para destinatários específicos.
Enviar e-mail [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Enviar e-mail (V2).

Esta operação é usada para enviar um e-mail para destinatários específicos.
Excluir e-mail

Esta operação é usada para excluir um e-mail específico permanentemente.
Mover e-mail para a lixeira

Esta operação é usada para mover um e-mail específico para a lixeira.
Obter detalhes de e-mail

Esta operação recupera os detalhes de um e-mail específico.
Responder ao e-mail (V2)

Esta operação é usada para responder a um e-mail específico.
Responder ao e-mail [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Responder ao e-mail (V2).

Esta operação é usada para responder a um e-mail específico.

Enviar e-mail (V2)

ID da Operação:
SendEmailV2

Esta operação é usada para enviar um e-mail para destinatários específicos.

Parâmetros

Name Chave Necessário Tipo Description
Para
 To True email

Uma lista de endereços de e-mail válidos separados por ponto-e-vírgula ou vírgula.
CC
 Cc email

Uma lista de endereços de e-mail válidos separados por ponto-e-vírgula ou vírgula.
CBC
 Bcc email

Uma lista de endereços de e-mail válidos separados por ponto-e-vírgula ou vírgula.
Assunto
 Subject string

Assunto do e-mail enviado.
Body
 Body html

Corpo do e-mail enviado.
Importância
 Importance string

Importância associada à mensagem de e-mail.
Nome
 Name True string

Título do anexo.
Content
 ContentBytes True byte

Corpo do anexo.
Tipo de conteúdo
 ContentType string

Tipo de conteúdo no anexo.

Enviar e-mail [DEPRECATED]

ID da Operação:
SendEmail

Esta ação foi preterida. Em vez disso, use Enviar e-mail (V2).

Esta operação é usada para enviar um e-mail para destinatários específicos.

Parâmetros

Name Chave Necessário Tipo Description
Para
 To True email

Uma lista de endereços de e-mail válidos separados por ponto-e-vírgula ou vírgula.
CC
 Cc email

Uma lista de endereços de e-mail válidos separados por ponto-e-vírgula ou vírgula.
CBC
 Bcc email

Uma lista de endereços de e-mail válidos separados por ponto-e-vírgula ou vírgula.
Assunto
 Subject string

Assunto do e-mail enviado.
Body
 Body string

Corpo do e-mail enviado.
É HTML
 IsHtml boolean

True para enviar o e-mail como HTML. (padrão: True)
Importância
 Importance string

Importância associada à mensagem de e-mail.
Nome
 Name True string

Título do anexo.
Content
 ContentBytes True byte

Corpo do anexo.
Tipo de conteúdo
 ContentType string

Tipo de conteúdo no anexo.

Excluir e-mail

ID da Operação:
DeleteEmail

Esta operação é usada para excluir um e-mail específico permanentemente.

Parâmetros

Name Chave Necessário Tipo Description
ID da mensagem
 id True string

ID do e-mail a ser excluído.

Mover e-mail para a lixeira

ID da Operação:
TrashEmail

Esta operação é usada para mover um e-mail específico para a lixeira.

Parâmetros

Name Chave Necessário Tipo Description
ID da mensagem
 id True string

ID do e-mail para ir para a lixeira.

Obter detalhes de e-mail

ID da Operação:
GetEmail

Esta operação recupera os detalhes de um e-mail específico.

Parâmetros

Name Chave Necessário Tipo Description
ID da mensagem
 id True string

ID exclusivo da mensagem de e-mail.
Incluir anexos
 includeAttachments boolean

Se definido como true, os anexos também serão recuperados junto com o e-mail.

Devoluções

Detalhes associados a uma mensagem de e-mail específica.

Body
DetailedReceiveMessage

Responder ao e-mail (V2)

ID da Operação:
ReplyToV2

Esta operação é usada para responder a um e-mail específico.

Parâmetros

Name Chave Necessário Tipo Description
ID da mensagem
 id True string

ID do e-mail para responder.
Para
 To email

Exemplo: recipient1@domain.com; recipient2@domain.com
CC
 Cc email

Exemplo: recipient1@domain.com; recipient2@domain.com
CBC
 Bcc email

Exemplo: recipient1@domain.com; recipient2@domain.com
Assunto
 Subject string

Assunto do e-mail (se vazio, o assunto original usado).
Body
 Body html

Conteúdo do e-mail.
Responder a todos
 ReplyAll boolean

True para responder a todos os destinatários. (padrão: False)
Importância
 Importance string

Escolha uma importância. (padrão: Normal)
Nome
 Name True string

Título do anexo.
Content
 ContentBytes True byte

Corpo do anexo.
Tipo de conteúdo
 ContentType string

Tipo de conteúdo no anexo.

Responder ao e-mail [DEPRECATED]

ID da Operação:
ReplyTo

Esta ação foi preterida. Em vez disso, use Responder ao e-mail (V2).

Esta operação é usada para responder a um e-mail específico.

Parâmetros

Name Chave Necessário Tipo Description
ID da mensagem
 id True string

ID do e-mail para responder.
Para
 To email

Exemplo: recipient1@domain.com; recipient2@domain.com
CC
 Cc email

Exemplo: recipient1@domain.com; recipient2@domain.com
CBC
 Bcc email

Exemplo: recipient1@domain.com; recipient2@domain.com
Assunto
 Subject string

Assunto do e-mail (se vazio, o assunto original usado).
Body
 Body string

Conteúdo do e-mail.
Responder a todos
 ReplyAll boolean

True para responder a todos os destinatários. (padrão: False)
É HTML
 IsHtml boolean

True para enviar a resposta como HTML. (padrão: True)
Importância
 Importance string

Escolha uma importância. (padrão: Normal)
Nome
 Name True string

Título do anexo.
Content
 ContentBytes True byte

Corpo do anexo.
Tipo de conteúdo
 ContentType string

Tipo de conteúdo no anexo.

Acionadores

Quando chega um novo e-mail

Esta operação é acionada quando chega um novo e-mail correspondente aos critérios especificados.

Quando chega um novo e-mail

ID da Operação:
OnNewEmail

Esta operação é acionada quando chega um novo e-mail correspondente aos critérios especificados.

Parâmetros

Name Chave Necessário Tipo Description
Etiqueta
 label string

Escolha um rótulo (padrão: Caixa de entrada).
Para
 to email

Uma lista de endereços de e-mail válidos separados por ponto-e-vírgula ou vírgula.
De
 from email

Exemplo: Sender1 | sender2@domain.com.
Assunto
 subject string

String para procurar no assunto.
Importância
 importance string

Verdade se o e-mail deve ser importante. (padrão: Todos).
Estrelado
 starred string

True se o e-mail deve ser estrelado. (padrão: Todos).
Tem anexos
 fetchOnlyWithAttachments boolean

True para recuperar apenas e-mails com anexos.
Incluir anexos
 includeAttachments boolean

True para recuperar anexos junto com o e-mail.

Devoluções

Detalhes associados a uma mensagem de e-mail específica.

Body
DetailedReceiveMessage

Definições

DetailedReceiveMessage

Detalhes associados a uma mensagem de e-mail específica.

Name Caminho Tipo Description
De
 From email

Endereço de e-mail a partir do qual a mensagem foi enviada.
Nome do remetente
 SenderName string

Nome do remetente do e-mail
Para
 To email

Endereço de e-mail para o qual a mensagem foi enviada.
CC
 Cc email

Endereços de e-mail contidos no campo CC.
CBC
 Bcc email

Endereços de e-mail contidos no campo BCC.
Assunto
 Subject string

Assunto ou tópico associado à mensagem de e-mail.
Body
 Body string

Conteúdo da mensagem de e-mail.
Trechos
 Snippet string

Uma pequena parte do texto da mensagem.
IDs de rótulo
 LabelIds array of string

Lista de etiquetas associadas à mensagem de e-mail.
Recebeu Date-Time
 DateTimeReceived date-time

Exemplo:2017-05-03T20:08:57+00:00
Tamanho estimado
 EstimatedSize integer

Tamanho estimado em bytes da mensagem.
É lido?
 IsRead boolean

True se a mensagem for lida; falso caso contrário.
É HTML
 IsHtml boolean

True se a mensagem estiver em formato HTML.
Tem anexos
 HasAttachments boolean

True se a mensagem tiver anexos.
Attachments
 Attachments array of Attachment

Lista de anexos à mensagem de e-mail.
ID da mensagem
 Id string

O ID imutável da mensagem.
Thread ID
 ThreadId string

O ID do thread ao qual a mensagem pertence.

Anexo

Propriedades de um anexo de e-mail.

Name Caminho Tipo Description
Nome
 Name string

Título do anexo.
Content
 ContentBytes byte

Corpo do anexo.
Tipo de conteúdo
 ContentType string

Tipo de conteúdo no anexo.