Gmail

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

Service	Class	Regions
Copilot Studio	Standard	Todas as regiões do Power Automate , exceto as seguintes:      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos	Standard	Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:      - Regiões do Azure China      - Departamento de Defesa dos EUA (DoD)
Power Apps	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)
Power Automate	Standard	Todas as regiões do Power Automate , 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
Publicador	Microsoft
Site	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 dá suporte a vários tipos de autenticação:

• Usar aplicativo compartilhado padrão
• Traga seu próprio aplicativo

O aplicativo compartilhado padrão usa um aplicativo Cliente do Google mantido pela Microsoft. Nesse caso, ao entrar em sua conta do Gmail, você será solicitado a consentir com o aplicativo Microsoft Power Platform .

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

Para usar seu próprio aplicativo Cliente OAuth do Google 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. Usar o aplicativo no conector do Gmail

Criando um aplicativo cliente OAuth no Google

Para criar seu próprio aplicativo cliente do Google OAuth, você precisará primeiro entrar.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 de API do Gmail do Google. O Google fornece uma ferramenta de instalação para orientá-lo durante o processo de criação de um projeto para você, habilitar 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ê encontrará ú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 chamado "Meu Projeto".
• A ferramenta habilitará a API do Gmail no projeto.
• A ferramenta tentará descobrir o tipo de credencial necessário. Você precisará obter um aplicativo cliente OAuth.
  • Selecione a API do Gmail para a API que você usará (se ainda não estiver selecionada).
  • Selecione o servidor Web de onde você chamará a API.
  • Selecione dados do usuário para os dados que você acessará.
• A ferramenta orientará você na configuração de uma tela de consentimento do OAuth.
  • Selecione o tipo de usuário (Interno ou Externo). Se você estiver usando uma conta de consumidor do Gmail, não poderá selecionar Interno.
  • 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 em 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

    Esse é 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 cliente OAuth.
  • 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

Usando seu próprio aplicativo no conector do Gmail

Depois de criar o aplicativo cliente Google OAuth, você poderá usá-lo durante a criação de uma conexão do Gmail.

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

Clique em Entrar para entrar em sua conta do Gmail. Isso solicitará que você entre em sua conta do Gmail e, em seguida, autorize o acesso ao aplicativo Google criado acima.

Problemas e limitações conhecidos

Limitações de gatilho para um grande número de emails de entrada

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

Quando um novo email chega, o gatilho pode ignorar intermitentemente emails 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 emails (possivelmente devido a verificações de segurança de anexos), portanto, os emails são recebidos com um determinado atraso.

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

• Usar emails 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 do consumidor. Configure o gatilho nessa nova conta. Como essa é uma conta de consumidor, acreditamos que o atraso será minimizado e o gatilho não ignorará esses emails.

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

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

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

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

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

  • Usar a ação Obter detalhes do email para obter conteúdo de email por ID

Usando o conector do Gmail com contas do Gmail de consumidor

Em conformidade com a política de segurança e privacidade do Google, os clientes que usam contas do Gmail de consumidor (contas que terminam @gmail.com e @googlemail.com) só podem se conectar a um conjunto limitado de serviços no Power Automate e aplicativos lógicos. Os clientes que usam contas do Google Workspace (anteriormente G Suite) não são afetados por essa alteração. Se você precisar usar o conector do Gmail com serviços não especificados na lista abaixo, será necessário registrar sua própria ID de aplicativo no Google. Abaixo está a lista dos serviços aprovados atuais, observe que esta lista está sujeita a alterações no futuro de acordo com as políticas do Google:

• Serviços do Google: Gmail, Google Calendar, Google Contacts, Google Drive, Google Sheets, Google Tasks
• Ações e gatilhos internos: Controle, Construtor de IA, Operações de Dados, Data e Hora, Funções numéricas, Agentes Virtuais do Power, Power Apps, Solicitação, Agendamento, Funções de Texto, Variáveis, Botão Fluxo, Localização
• Conjunto limitado de serviços da 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 desabilitado.

Calculando unidades de trabalho

O conector tem um limite de limitação (consulte aqui) sobre o 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 email chega , o gatilho : 10 + (5 * attachmentsCount);
  • Se o gatilho retornar novo email: 5 unidades para listar mensagens + 5 unidades para obter mensagem + 5 unidades * contagem de anexos.
  • Se o gatilho não retornar um novo email: 5 unidades para listar mensagens.
• Ação Enviar email (V2): 100 unidades.
• Responder à ação de email (V2): 105 + (5 * attachmentsCount);
  • 5 unidades para obter a mensagem original + 100 unidades para enviar mensagem de resposta + 5 unidades * contagem de anexos embutidos na mensagem original.
• Para todas as outras ações: 10 unidades.

Conector aprofundado

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

Limites Gerais

Nome	Value
Tamanho máximo do email (em MB)	35
Tamanho máximo do anexo (em MB)	30

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Traga seu próprio aplicativo	Entre usando seu próprio aplicativo do Google. Para obter mais detalhes, consulte 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	Entre usando o aplicativo Padrão do Google.	Todas as regiões	Não compartilhável
Padrão [PRETERIDO]	Essa 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 seu próprio aplicativo

ID de autenticação: byoa

Aplicável: todas as regiões

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

Essa não é uma conexão compartilhável. Se o aplicativo de energia 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	ID do cliente (ou aplicativo) do seu aplicativo google	Verdade
Segredo de Cliente	secureString	Segredo do cliente do seu aplicativo google	Verdade

Usar aplicativo compartilhado padrão

ID de autenticação: aplicativo compartilhado

Aplicável: todas as regiões

Entre usando o aplicativo Padrão do Google.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Padrão [PRETERIDO]

Aplicável: todas as regiões

Essa 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.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limitações

Nome	Chamadas	Período de renovação
Chamadas à API por conexão	60	60 segundos
Unidades de trabalho por dia	90000	86400 segundos

Ações

Eliminar e-mail	Essa operação é usada para excluir permanentemente um email específico.
Enviar email (V2)	Essa operação é usada para enviar um email para destinatários específicos.
Enviar email [PRETERIDO]	Esta ação foi preterida. Em vez disso, use Enviar email (V2 ). Essa operação é usada para enviar um email para destinatários específicos.
Mover o email para o lixo	Essa operação é usada para mover um email específico para o lixo.
Obter detalhes do email	Esta operação recupera os detalhes de um email específico.
Responder a email (V2)	Essa operação é usada para responder a um email específico.
Responder a email [PRETERIDO]	Esta ação foi preterida. Em vez disso, use Responder a email (V2 ). Essa operação é usada para responder a um email específico.

Eliminar e-mail

Enviar email (V2)

Enviar email [PRETERIDO]

Mover o email para o lixo

Obter detalhes do email

Responder a email (V2)

Responder a email [PRETERIDO]

Gatilhos

Quando um novo email chega

Essa operação é disparada quando um novo email que corresponde aos critérios especificados chega.

Quando um novo email chega

Definições

DetailedReceiveMessage

Anexo