Za pomocą etykiet możesz oznaczać, porządkować i kategoryzować wiadomości i 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 oraz zastosować jedną etykietę do wielu wiadomości lub wątków.
Informacje o tym, jak tworzyć, pobierać, wyświetlać, aktualizować i usuwać etykiety, znajdziesz w dokumentacji etykiet.
Aby zarządzać etykietami, musisz użyć zakresu https://www.googleapis.com/auth/gmail.labels. Więcej informacji o zakresach znajdziesz w informacjach na temat autoryzacji i uwierzytelniania w interfejsie Gmail API.
Rodzaje etykiet
Etykiety dzielą się na 2 rodzaje: zarezerwowane etykiety SYSTEM i niestandardowe etykiety USER.
Etykiety systemowe zwykle odpowiadają wstępnie zdefiniowanym elementom interfejsu Gmaila w przeglądarce, takim jak skrzynka odbiorcza. Nazwy etykiet systemowych są zarezerwowane. Nie można utworzyć etykiety USER o nazwie takiej samej jak nazwa etykiety SYSTEM. W tabeli poniżej znajdziesz kilka najpopularniejszych etykiet systemowych Gmaila:
| Nazwa | Można je 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, wstawianych za pomocą messages.insert
i adresu e-mail użytkownika w nagłówku From lub wysyłanych przez użytkownika za pomocą
interfejsu internetowego. |
DRAFT |
nie | Stosowane automatycznie do wszystkich draft wiadomości 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 Aktualności 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 istnieją tylko w wiadomościach. Jeśli na przykład wyświetlisz listę etykiet w wątku, otrzymasz listę etykiet, które znajdują się w dowolnej wiadomości w wątku. Etykieta może nie być widoczna w każdej wiadomości w wątku. Do wiadomości możesz zastosować wiele etykiet, ale nie możesz ich stosować do wiadomości w wersji roboczej.
Dodawanie etykiet do wątków i usuwanie ich z wątków
Gdy dodasz lub usuniesz etykietę z wątku, dodasz lub usuniesz ją ze wszystkich istniejących wiadomości w tym wątku.
Jeśli po dodaniu etykiety do wątku zostaną dodane do niego nowe wiadomości, nie odziedziczą one istniejącej etykiety powiązanej z wątkiem. Aby dodać etykietę do tych wiadomości, ponownie dodaj ją do wątku.
Aby dodać lub usunąć etykiety powiązane z wątkiem, użyj threads.modify.
Dodawanie i usuwanie etykiet z 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. Etykieta nie zostanie dodana do innych wiadomości w wątku.
Jeśli usuniesz etykietę z wiadomości, która była jedyną wiadomością w wątku z tą etykietą, etykieta zostanie usunięta również z wątku.
Aby dodać lub usunąć etykiety zastosowane do wiadomości, użyj ikony
messages.modify.