Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Masz 5 minut?
Pomóż nam ulepszyć dokumentację Google Workspace, wypełniając krótką ankietę online.
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
Poniżej znajdziesz listę typowych terminów używanych w interfejsie Gmail API:
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 wiadomości.
Wątek
Zbiór powiązanych wiadomości tworzących rozmowę. W aplikacji klienta poczty e-mail wątek powstaje, gdy co najmniej jeden odbiorca odpowie na wiadomość własną wiadomością.
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. 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. Te etykiety mogą być usuwane lub modyfikowane przez użytkownika lub aplikację. Etykieta użytkownika jest reprezentowana przez zasób etykiety.
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 wersji roboczej.
Dalsze kroki
Więcej informacji o tworzeniu aplikacji z wykorzystaniem interfejsów Google Workspace API, w tym o obsłudze uwierzytelniania i autoryzacji, znajdziesz w artykule Pierwsze kroki jako deweloper Google Workspace.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-03 UTC."],[],[],null,["|-------------------------------------------------------------------------------------------------------------------------------------------|\n| Got 5 minutes? Help us improve our Google Workspace documentation by taking a quick [online survey](https://forms.gle/XcqRP3PJiQv9ADuj9). |\n\nThe Gmail API is a RESTful API that can be used to access Gmail mailboxes and\nsend mail. For most web applications the Gmail API is the best choice for\nauthorized access to a user's Gmail data and is suitable for various\napplications, such as:\n\n- Read-only mail extraction, indexing, and backup\n- Automated or programmatic message sending\n- Email account migration\n- Email organization including filtering and sorting of messages\n- Standardization of email signatures across an organization\n\nFollowing is a list of common terms used in the Gmail API:\n\n*Message*\n: An email message containing the sender, recipients, subject, and body. After a\n message has been created, a message cannot be changed. A message is represented\n by a [message resource](/workspace/gmail/api/reference/rest/v1/users.messages#Message).\n\n*Thread*\n: A collection of related messages forming a conversation. In an email client\n app, a thread is formed when one or more recipients respond to a message with\n their own message.\n\n*Label*\n\n: A mechanism for organizing messages and threads. For example,\n the label \"taxes\" might be created and applied to all messages and threads\n having to do with a user's taxes. There are two types of labels:\n\n *System labels*\n : Internally-created labels, such as `INBOX`, `TRASH`, or `SPAM`. These labels\n cannot be deleted or modified. However, some system labels, such as `INBOX`\n can be applied to, or removed from, messages and threads.\n\n *User labels*\n : Labels created by a user. These labels can be deleted or modified by the\n user or an application. A user label is represented by a\n [label resource](/workspace/gmail/api/reference/rest/v1/users.labels).\n\n*Draft*\n\n: An unsent message. A message contained within the draft can be replaced.\n Sending a draft automatically deletes the draft and creates a message with\n the `SENT` system label. A draft is represented by a\n [draft resource](/workspace/gmail/api/reference/rest/v1/users.drafts).\n\nNext steps\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer\n to [Get started as a Google Workspace developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Gmail API app, read the\n [Quickstarts overview](/workspace/gmail/api/guides/quickstarts-overview)."]]
