A API Gmail é uma API RESTful que pode ser usada para acessar caixas de e-mail 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 de mensagens automáticas ou programáticas
- Migração de conta de e-mail
- Organização de e-mails, incluindo filtragem e classificação de mensagens
- Padronização de assinaturas de e-mail em uma organização
Confira a seguir uma lista de termos comuns usados na API Gmail:
- Mensagem
- Uma mensagem de e-mail com remetente, destinatários, assunto e corpo. Depois que uma mensagem é criada, 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 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 marcador "impostos" pode ser criado e aplicado a todas as mensagens e conversas relacionadas aos impostos de um usuário. Há dois tipos de rótulos:
- Rótulos do sistema
- Rótulos criados internamente, como
INBOX
,TRASH
ouSPAM
. Esses rótulos não podem ser excluídos nem modificados. No entanto, alguns marcadores do sistema, comoINBOX
, podem ser aplicados ou removidos de mensagens e linhas de conversa. - Rótulos do usuário
- Marcadores 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 contida no rascunho pode ser substituída. O envio de um rascunho 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 as APIs do Google Workspace, incluindo o processamento de autenticação e autorização, consulte Começar a desenvolver para o Google Workspace.
Para saber como configurar e executar um app simples da API Gmail, leia a visão geral dos tutoriais de início rápido.