A API Gmail é uma API RESTful que pode ser usada para acessar caixas de correio do Gmail e enviar e-mails. Para a maioria dos aplicativos da Web, a API Gmail é a melhor escolha para acesso autorizado aos dados do Gmail de um usuário e é adequada para vários aplicativos, como:
- Extração, indexação e backup de e-mails somente leitura
- Envio automático ou programático de mensagens
- Migração da conta de e-mail
- Organização de e-mails, incluindo filtragem e classificação de mensagens
- Padronização das assinaturas de e-mail na organização
Veja a seguir uma lista de termos comuns usados na API Gmail:
- Mensagem
- Uma mensagem de e-mail com o remetente, os destinatários, o assunto e o corpo. Após a criação de uma mensagem, ela não pode ser alterada. Uma mensagem é representada por um recurso de mensagem.
- Thread
- Um conjunto de mensagens relacionadas que formam uma conversa. Em um app cliente de e-mail, uma conversa é formada quando um ou mais destinatários respondem a uma mensagem com a própria mensagem.
- Rótulo
Um mecanismo para organizar mensagens e conversas. Por exemplo, o rótulo "tributos" pode ser criado e aplicado a todas as mensagens e conversas relacionadas aos tributos de um usuário. Há dois tipos de identificadores:
- Rótulos do sistema
- Rótulos criados internamente, como
INBOX
,TRASH
ouSPAM
. Esses rótulos não podem ser excluídos ou modificados. No entanto, alguns rótulos do sistema, comoINBOX
, podem ser aplicados ou removidos de mensagens e linhas de execução. - Rótulos de usuários
- Rótulos criados por um usuário. Esses rótulos podem ser excluídos ou modificados pelo usuário ou por um aplicativo. Um rótulo de usuário é representado por um recurso de rótulo.
- Rascunho
Uma mensagem não enviada. Uma mensagem do rascunho pode ser substituída. O envio dele exclui automaticamente o rascunho e cria uma mensagem com o rótulo do sistema
SENT
. Um rascunho é representado por um recurso de rascunho.
Próximas etapas
Para saber mais sobre o desenvolvimento com APIs do Google Workspace, incluindo o gerenciamento de autenticação e autorização, consulte Primeiros passos como desenvolvedor do Google Workspace.
Para saber como configurar e executar um app simples da API Gmail, leia a Visão geral dos guias de início rápido.