Omówienie interfejsu Gmail API

Gmail API to interfejs API w formacie REST, którego można używać do uzyskiwania dostępu do skrzynek pocztowych Gmaila i wysyłania e-maili. W przypadku większości aplikacji internetowych interfejs Gmail API jest najlepszym wyborem, jeśli chodzi o autoryzowany dostęp do danych użytkownika w Gmailu. Nadaje się do różnych aplikacji, takich jak:

  • Tylko do odczytu: wyodrębnianie, indeksowanie i tworzenie kopii zapasowych poczty
  • Automatyczne lub programowe wysyłanie wiadomości
  • Migracja konta e-mail
  • organizowanie e-maili, w tym filtrowanie i sortowanie wiadomości;
  • Ujednolicenie podpisów e-maili w organizacji

Często spotykane terminy

Oto lista najczęstszych terminów używanych w tym interfejsie API:

Użytkownik przekazujący połączenie i użytkownik odbierający połączenie
Delegujący to użytkownik Gmaila, który przyznaje dostęp do skrzynki pocztowej innemu użytkownikowi w tej samej organizacji Google Workspace. Użytkownik, który otrzymuje ten dostęp, to pełnomocnik. Przedstawiciele mogą czytać, wysyłać i usuwać wiadomości, a także wyświetlać i dodawać kontakty w imieniu właściciela konta. Więcej informacji znajdziesz w artykule Zarządzanie przedstawicielami.
Draft
Niewysłana wiadomość. Wiadomość w wersji roboczej można zastąpić. Wysłanie wersji roboczej powoduje jej automatyczne usunięcie i utworzenie wiadomości z etykietą systemową SENT. Wersja robocza jest reprezentowana przez zasób drafts. Więcej informacji znajdziesz w artykule Praca z wersjami roboczymi.
Filtry
Zaawansowane reguły skonfigurowane na koncie, które oceniają wiadomości przychodzące pod kątem określonych kryteriów dopasowania (takich jak nadawca, temat lub rozmiar). Gdy wiadomość pasuje do filtra, automatycznie wywołuje on działania takie jak dodawanie lub usuwanie etykiet czy przekazywanie e-maila na określony adres. Więcej informacji znajdziesz w artykule Zarządzanie filtrami.
Adresy do przekazywania dalej
Określone, zweryfikowane adresy e-mail skonfigurowane do odbierania automatycznie przekazywanych wiadomości z konta użytkownika. Zanim adres będzie mógł być używany w regule przekierowania lub filtrze, musi zostać oficjalnie zarejestrowany i zweryfikowany w celu potwierdzenia własności. Więcej informacji znajdziesz w artykule Zarządzanie przekazywaniem.
Etykieta

Mechanizm porządkowania wiadomości i wątków. Na przykład etykieta „podatki” może zostać utworzona i zastosowana do wszystkich wiadomości i wątków związanych z podatkami użytkownika. Więcej informacji znajdziesz w artykule Zarządzanie etykietami.

Istnieją 2 rodzaje etykiet:

Etykiety systemowe
Etykiety utworzone wewnętrznie, np. INBOX, TRASH lub SPAM. Tych etykiet nie można usunąć ani zmodyfikować. Niektóre etykiety systemowe, np.INBOX, można jednak dodawać do wiadomości i wątków oraz z nich usuwać.
Etykiety użytkownika
Etykiety utworzone przez użytkownika. Etykiety te mogą być usuwane lub modyfikowane przez użytkownika lub aplikację. Etykieta użytkownika jest reprezentowana przez zasób labels.
Wiadomość

Wiadomość e-mail zawierająca nadawcę, odbiorców, temat i treść. Po utworzeniu wiadomości nie można jej zmienić. Wiadomość jest reprezentowana przez zasób messages.

Powiadomienia push

System powiadomień po stronie serwera zintegrowany z Google Cloud Pub/Sub. Aplikacje mogą „obserwować” skrzynkę pocztową, a interfejs Gmail API będzie wysyłać automatyczne webhooki lub alerty za każdym razem, gdy nastąpi zmiana (np. przyjdzie nowy e-mail). Dzięki temu aplikacja nie musi ciągle odpytywać serwera o aktualizacje. Więcej informacji znajdziesz w sekcji Powiadomienia push.

Certyfikaty S/MIME

Certyfikaty cyfrowe przesłane do określonych aliasów „Wyślij jako”, które umożliwiają użytkownikowi wysyłanie szyfrowanych i podpisanych cyfrowo e-maili, co zapewnia bezpieczeństwo wiadomości i autentyczność nadawcy. Więcej informacji znajdziesz w artykule Zarządzanie certyfikatami S/MIME.

Aliasy „Wyślij jako”

Są to różne adresy e-mail, z których konto jest uprawnione do wysyłania poczty. Każde konto ma co najmniej 1 alias reprezentujący podstawowy adres e-mail. Aliasy odpowiadają funkcji „Wyślij pocztę jako” w interfejsie internetowym Gmaila i stanowią podstawę do konfigurowania podpisów e-mail dla poszczególnych adresów. Więcej informacji znajdziesz w artykule Zarządzanie aliasami.

Wątek

Zbiór powiązanych wiadomości tworzących rozmowę. W aplikacji klienta poczty e-mail wątek powstaje, gdy co najmniej 1 odbiorca odpowie na wiadomość własną wiadomością. Więcej informacji znajdziesz w artykule Zarządzanie wątkami.

  • Więcej informacji o tworzeniu aplikacji za pomocą interfejsów Google Workspace API, w tym o obsłudze uwierzytelniania i autoryzacji, znajdziesz w artykule Tworzenie aplikacji w Google Workspace.

  • Aby dowiedzieć się, jak skonfigurować i uruchomić aplikację interfejsu Gmail API, przeczytaj szybki start.