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.