Omówienie interfejsu Gmail API

Gmail API – 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 Gmail API jest najlepszym wyborem, jeśli chodzi o autoryzowany dostęp do danych Gmaila użytkownika. Nadaje się do różnych aplikacji, takich jak:

  • wyodrębnianie, indeksowanie i tworzenie kopii zapasowych poczty tylko do odczytu;
  • automatyczne lub programowe wysyłanie wiadomości;
  • przenoszenie kont e-mail;
  • organizowanie e-maili, w tym filtrowanie i sortowanie wiadomości;
  • standaryzacja podpisów e-mail w całej organizacji.

Często spotykane terminy

Oto lista często spotykanych terminów używanych w tym interfejsie API:

Delegator i przedstawiciel
Delegator to użytkownik Gmaila, który przyznaje innemu użytkownikowi w tej samej organizacji Google Workspace dostęp do skrzynki pocztowej. Użytkownik, który otrzymuje ten dostęp, jest przedstawicielem. Przedstawiciele mogą czytać, wysyłać i usuwać wiadomości, a także wyświetlać i dodawać kontakty w imieniu konta delegatora. Więcej informacji znajdziesz w artykule Zarządzanie przedstawicielami.
Wersja robocza
Niewysłana wiadomość. Wiadomość zawartą 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, filtry automatycznie wywołują działania, takie jak dodawanie lub usuwanie etykiet albo 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 można użyć w regule przekierowania lub filtrze, musi zostać oficjalnie zarejestrowany i zweryfikowany, aby potwierdzić jego własność. Więcej informacji znajdziesz w artykule Zarządzanie przekazywaniem dalej.
Etykieta

Mechanizm porządkowania wiadomości i wątków. Możesz na przykład utworzyć etykietę „podatki” i zastosować ją 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, takie jak INBOX, TRASH czy SPAM. Tych etykiet nie można usuwać ani modyfikować. Niektóre etykiety systemowe, takie jak INBOX, można jednak stosować do wiadomości i wątków oraz usuwać z nich.
Etykiety użytkownika
Etykiety utworzone przez użytkownika. Te etykiety 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 messages zasób.

Powiadomienia push

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

Certyfikaty S/MIME

Certyfikaty cyfrowe przesyłane do określonych aliasów „Wyślij jako”, które umożliwiają użytkownikowi wysyłanie zaszyfrowanych 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”

Reprezentują 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 Gmaila i są też 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 tworzy się, 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ę Gmail API, przeczytaj przewodniki Szybki start.