Zarządzaj etykietami

Za pomocą etykiet możesz oznaczać tagami, porządkować i klasyfikować wiadomości oraz wątki w Gmailu. Etykieta ma relację wiele do wielu z wiadomościami i wątkami: możesz zastosować wiele etykiet do jednej wiadomości lub wątku, a następnie zastosować jedną etykietę do wielu wiadomości lub wątków.

Więcej informacji na temat tworzenia, pobierania, tworzenia listy, aktualizowania i usuwania etykiet znajdziesz w dokumentacji etykiet.

Aby zarządzać etykietami, musisz używać zakresu https://www.googleapis.com/auth/gmail.labels. Więcej informacji o zakresach znajdziesz w artykule na temat autoryzacji i uwierzytelniania interfejsu Gmail API.

Typy etykiet

Etykiety są dostępne w 2 odmianach: zarezerwowanych etykiet SYSTEM i etykiet niestandardowych USER. Etykiety systemowe zazwyczaj odpowiadają wstępnie zdefiniowanym elementom w interfejsie internetowym Gmaila, na przykład skrzynce odbiorczej. Nazwy etykiet systemowych są zarezerwowane. Nie można utworzyć żadnej etykiety USER o takiej samej nazwie jak jakakolwiek etykieta SYSTEM. W tabeli poniżej znajdziesz nazwy kilku najpopularniejszych etykiet systemowych Gmaila:

Nazwa Można zastosować ręcznie Uwagi
INBOX tak
SPAM tak
TRASH tak
UNREAD tak
STARRED tak
IMPORTANT tak
SENT nie Stosowane automatycznie do wiadomości wysyłanych za pomocą drafts.send lub messages.send, wstawionych za pomocą symbolu messages.insert i adresu e-mail użytkownika w nagłówku From lub wysyłanych przez użytkownika przez interfejs internetowy.
DRAFT nie Stosowane automatycznie do wszystkich wiadomości na koncie draft utworzonych za pomocą interfejsu Gmail API lub interfejsu Gmaila.
CATEGORY_PERSONAL tak Odpowiada wiadomościom wyświetlanym na karcie Osobiste w interfejsie Gmaila.
CATEGORY_SOCIAL tak Odpowiada wiadomościom wyświetlanym na karcie Społeczności w interfejsie Gmaila.
CATEGORY_PROMOTIONS tak Odpowiada wiadomościom wyświetlanym na karcie Oferty w interfejsie Gmaila.
CATEGORY_UPDATES tak Odpowiada wiadomościom wyświetlanym na karcie Aktualizacje w interfejsie Gmaila.
CATEGORY_FORUMS tak Odpowiada wiadomościom wyświetlanym na karcie Fora w interfejsie Gmaila.

Zarządzanie etykietami wiadomości i wątków

Etykiety występują tylko w wiadomościach. Jeśli na przykład podasz etykiety wątku, uzyskasz listę etykiet, które istnieją przy wszystkich wiadomościach w wątku. Etykieta może nie istnieć dla każdej wiadomości w wątku. Do wiadomości można stosować wiele etykiet, ale nie można ich stosować do wersji roboczych wiadomości.

dodawać i usuwać etykiety w wątkach;

Gdy dodajesz etykietę do wątku lub ją usuwasz, możesz ją dodać do wszystkich istniejących wiadomości w wątku lub ją z niej usunąć.

Jeśli wiadomości zostaną dodane do wątku po dodaniu etykiety, nowe wiadomości nie odziedziczą istniejącej etykiety powiązanej z wątkiem. Aby dodać etykietę do tych wiadomości, dodaj ją ponownie do wątku.

Aby dodać lub usunąć etykiety powiązane z wątkiem, użyj narzędzia threads.modify.

Dodawanie i usuwanie etykiet do wiadomości

Gdy dodasz etykietę do wiadomości, zostanie ona dodana do tej wiadomości i powiązana z wątkiem, do którego należy wiadomość. Nie jest ona dodawana do innych wiadomości w wątku.

Jeśli usuniesz etykietę z wiadomości, która jest jedyną wiadomością z tą etykietą w wątku, zostanie ona również usunięta z wątku.

Aby dodać lub usunąć etykiety zastosowane do wiadomości, użyj messages.modify.