Omówienie interfejsu Gmail API

Interfejs Gmail API to interfejs API w formacie REST, który umożliwia dostęp do skrzynek pocztowych Gmaila i wysyłanie e-maili. W przypadku większości aplikacji internetowych interfejs 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:

  • 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;
  • Standaryzacja 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, jest osobą upoważnioną. Przedstawiciele mogą czytać, wysyłać i usuwać wiadomości, a także wyświetlać i dodawać kontakty w imieniu delegującego. Więcej informacji znajdziesz w artykule Zarządzanie delegatami.
Draft
Niewysłana wiadomość. Możesz zastąpić wiadomość zawartą w wersji roboczej. Wysłanie wersji roboczej powoduje jej automatyczne usunięcie i utworzenie wiadomości z etykietą systemową SENT. Zasób drafts reprezentuje wersję roboczą. Więcej informacji znajdziesz w artykule Praca z wersjami roboczymi.
Filtry
Zaawansowane reguły skonfigurowane na koncie, które oceniają wiadomości przychodzące na podstawie 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 użyjesz adresu w regule przekierowania lub filtrze, musisz go zarejestrować i zweryfikować, aby potwierdzić, że jest on Twoją własnością. Więcej informacji znajdziesz w artykule Zarządzanie przekazywaniem.
Etykieta

Mechanizm organizowania 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. Więcej informacji znajdziesz w artykule Zarządzanie etykietami.

Istnieją 2 rodzaje etykiet:

Etykiety systemowe
Etykiety utworzone wewnętrznie, np. INBOX, TRASH lub SPAM. Nie możesz usuwać ani modyfikować tych etykiet. Możesz jednak stosować lub usuwać niektóre etykiety systemowe, np. INBOX, w wiadomościach i wątkach.
Etykiety użytkownika
Etykiety utworzone przez użytkownika. Użytkownik lub aplikacja może usunąć lub zmodyfikować te etykiety. Zasób labels reprezentuje etykietę użytkownika.
Wiadomość

Wiadomość e-mail zawierająca nadawcę, odbiorców, temat i treść. Po utworzeniu wiadomości nie możesz jej zmienić. Zasób messages reprezentuje wiadomość.

Powiadomienia push

System powiadomień po stronie serwera zintegrowany z Google Cloud Pub/Sub. Aplikacje mogą „obserwować” skrzynkę pocztową, a interfejs Gmail API wysyła automatyczne wywołania zwrotne lub alerty za każdym razem, gdy nastąpi zmiana (np. przyjdzie nowy e-mail). Eliminuje to konieczność odpytywania serwera przez aplikację w celu uzyskania aktualizacji. Więcej informacji znajdziesz w sekcji Powiadomienia push.

Certyfikaty S/MIME

Certyfikaty cyfrowe przesłane do określonych aliasów „Wyślij jako”. Te certyfikaty umożliwiają 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”

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 jako” w interfejsie internetowym Gmaila i stanowią podstawę do konfigurowania podpisów e-maili 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 kliencie 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ę interfejsu Gmail API, przeczytaj szybki start.