Ir para o conteúdo

Gmail (Beta) Atividade Ler Email

Introdução

Uma atividade Ler Email do Gmail (Beta), utilizando sua conexão do Gmail (Beta), recupera emails do Gmail e é destinada a ser usada como uma fonte para fornecer dados a uma operação.

Nota

Este conector está atualmente em beta. Para fornecer feedback, entre em contato com a Equipe de Produto Jitterbit.

Criar uma atividade Gmail (Beta) Ler Email

Uma instância de uma atividade Ler Email do Gmail (Beta) é criada a partir de uma conexão do Gmail (Beta) usando seu tipo de atividade Ler Email.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, veja Criando uma instância de atividade em Reutilização de componentes.

Uma atividade existente Ler Email do Gmail (Beta) pode ser editada a partir destes locais:

Configurar uma atividade Gmail (Beta) Ler Email

Siga estas etapas para configurar uma atividade Ler Email do Gmail (Beta):

Etapa 1: Insira um nome e especifique as configurações

Neste passo, forneça um nome para a atividade e especifique as opções de filtro de email. Cada elemento da interface do usuário deste passo é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Menu de endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, veja Alterar o endpoint atribuído em Telasa de configuração.

    • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint atualmente selecionado.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade de Ler Email do Gmail (Beta) e não deve conter barras normais / ou dois pontos :.

  • Selecionar opção de filtro: Selecione a opção de filtro a ser utilizada, seja Usar Campos de Filtro ou Usar Consulta Avançada.

    • Usar Campos de Filtro: Selecione para definir um filtro usando estes campos de filtro comuns:

      • De: Insira um email do remetente para filtrar. Por exemplo, jan@example.com.

      • Para: Insira um email do destinatário para filtrar. Por exemplo, jan@example.com.

      • Contém as Palavras: Insira palavras encontradas no assunto ou corpo do email para filtrar. Por exemplo, status do projeto.

    • Usar Consulta Avançada: Selecione para definir uma consulta de filtro que pode filtrar mais do que os campos de filtro comuns.

      • Filtro: Insira a consulta de filtro para filtrar. Por exemplo, after:2026/01/01 before:2026/02/01. Veja Refinar buscas no Gmail para uma lista abrangente de atributos de filtro.

  • Rótulos: Defina e ative rótulos para filtragem na tabela. A tabela é preenchida com esses rótulos por padrão:

    • CAIXA DE ENTRADA (ativado)
    • NÃO LIDOS (ativado)
    • DESTACADOS
    • IMPORTANTE
    • ENVIADOS
    • RASCUNHO
    • SPAM
    • LIXEIRA

    Nota

    Quando Usar Consulta Avançada é selecionado, os filtros de rótulo definidos no campo Filtro são processados com os filtros de rótulo definidos na tabela Rótulos.

    Clique no ícone de adicionar para adicionar uma linha à tabela, em seguida, insira um valor de rótulo e especifique se ele é usado na filtragem.

    Para salvar a linha, clique no ícone de enviar na coluna mais à direita.

    Para editar ou excluir uma única linha, passe o mouse sobre a coluna mais à direita e use o ícone de editar ou o ícone de excluir .

    Para excluir todas as linhas, clique em Limpar Tudo.

  • Marcar como Lido: Selecione para marcar os emails recuperados como lidos.

  • Configurações Opcionais: Clique para expandir configurações opcionais adicionais:

    • Limite: Insira o número máximo de emails a serem recuperados por página de resultados. O limite padrão é 100 e pode ser definido para um valor máximo de 500.
    • Token da Página: Insira um token de página para recuperar uma página específica de resultados de email. Usado para gerenciar a paginação de resultados.
    • Incluir Conteúdo de Anexos: Selecione para incluir anexos com os emails.

  • Salvar e Sair: Se ativado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede que você confirme que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

Quaisquer esquemas de solicitação ou resposta são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Esquema de Dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformações.

    Nota

    Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

    O conector Gmail (Beta) utiliza a API do Gmail. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

  • Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para regenerar esquemas do endpoint do Gmail (Beta). Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade Ler Email do Gmail (Beta), complete a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

As ações do menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, consulte o menu de ações da atividade em Conceitos básicos do conector.

As atividades Ler Email do Gmail (Beta) podem ser usadas como uma fonte com esses padrões de operação:

Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.