Gmail API to interfejs API typu REST, który umożliwia dostęp do skrzynek pocztowych Gmaila i wysyłanie poczty. W przypadku większości aplikacji internetowych interfejs Gmail API jest najlepszym wyborem w przypadku autoryzowanego dostępu do danych Gmaila użytkownika. Jest odpowiedni dla różnych aplikacji, takich jak:
- Wyodrębnianie, indeksowanie i tworzenie kopii zapasowych poczty (tylko do odczytu)
- Automatyczne lub zautomatyzowane wysyłanie wiadomości
- Migracja konta e-mail
- Organizacja poczty e-mail w tym filtrowanie i sortowanie wiadomości
- Standaryzacja podpisów e-maili w organizacji
Poniżej znajduje się lista typowych terminów używanych w interfejsie Gmail API:
- Wiadomość
- E-mail zawierający nadawcę, odbiorców, temat i treść. Po utworzeniu wiadomości nie można już jej zmienić. Wiadomość jest reprezentowana przez zasób wiadomości.
- Wątek
- Zbiór powiązanych wiadomości tworzących rozmowę. W aplikacji klienckiej poczty e-mail wątek powstaje, gdy co najmniej 1 odbiorca odpowie własną wiadomością.
- Etykieta
Mechanizm porządkowania wiadomości i wątków. Etykieta „podatki” można na przykład utworzyć i zastosować do wszystkich wiadomości i wątków związanych z podatkami użytkownika. Są 2 rodzaje etykiet:
- Etykiety systemowe
- Etykiety tworzone wewnętrznie, np.
INBOX
,TRASH
lubSPAM
. Takich etykiet nie można usuwać ani modyfikować. Niektóre etykiety systemowe, takie jakINBOX
, można jednak stosować do wiadomości i wątków lub z nich usuwać. - Etykiety użytkowników
- Etykiety tworzone przez użytkownika. Etykiety te mogą zostać usunięte lub zmienione przez użytkownika lub aplikację. Etykieta użytkownika jest reprezentowana przez zasób etykiety.
- Wersja robocza
Niewysłana wiadomość. Wiadomość znajdującą się w wersji roboczej można zastąpić. Wysłanie wersji roboczej powoduje automatyczne usunięcie jej wersji roboczej i utworzenie wiadomości z etykietą systemową
SENT
. Wersja robocza jest reprezentowana przez zasób w wersji roboczej.
Dalsze kroki
Więcej informacji o programowaniu z użyciem interfejsów Google Workspace API, w tym o obsłudze uwierzytelniania i autoryzacji, znajdziesz w artykule Pierwsze kroki jako programista Google Workspace.
Aby dowiedzieć się, jak skonfigurować i uruchomić prostą aplikację interfejsu Gmail API, przeczytaj krótkie wprowadzenie.