A API Gmail é uma API RESTful que pode ser usada para acessar caixas de e-mails 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 de assinaturas de e-mail em toda a organização
Veja a seguir uma lista de termos comuns usados na API Gmail:
- Mensagem
- Uma mensagem de e-mail contendo o remetente, os destinatários, o assunto e o corpo. Depois que uma mensagem é criada, ela não pode ser alterada. Uma mensagem é representada por um recurso de mensagem.
- Thread
- Uma coleção de mensagens relacionadas que formam uma conversa. Em um app de 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 marcadores:
- Marcadores de sistema
- Rótulos criados internamente, como
INBOX
,TRASH
ouSPAM
. Esses rótulos não podem ser excluídos ou modificados. No entanto, alguns marcadores do sistema, comoINBOX
, podem ser aplicados ou removidos de mensagens e conversas. - Rótulos do usuário
- Rótulos criados por um usuário. Esses rótulos podem ser excluídos ou modificados pelo usuário ou aplicativo. Um rótulo de usuário é representado por um recurso de rótulo.
- Rascunho
Uma mensagem não enviada. Uma mensagem no rascunho pode ser substituída. O envio de um rascunho exclui automaticamente o rascunho e cria uma mensagem com o rótulo de sistema
SENT
. Um rascunho é representado por um recurso de rascunho.
Próximas etapas
Para saber mais sobre o desenvolvimento com as 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.