Zarządzaj etykietami

Z tego dokumentu dowiesz się, jak zarządzać etykietami wątków i wiadomości za pomocą interfejsu Gmail API.

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 zasobie labels.

Aby zarządzać etykietami, musisz użyć https://www.googleapis.com/auth/gmail.labels zakresu nieobejmującego informacji poufnych. Więcej informacji o zakresach znajdziesz w artykule Wybieranie zakresów interfejsu Gmail API.

Rodzaje etykiet

Etykiety występują w 2 odmianach: zarezerwowane SYSTEM i niestandardowe USER.

Etykiety systemowe zwykle odpowiadają predefiniowanym elementom w interfejsie internetowym Gmaila, takim jak INBOX. 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 stosować ręcznie.	Uwagi
INBOX	tak
SPAM	tak
TRASH	tak
UNREAD	tak
STARRED	tak
IMPORTANT	tak
SENT	nie	Stosowane automatycznie do wiadomości, które: wysłane z użyciem drafts.send lub messages.send. wstawiony za pomocą messages.insert i adres e-mail użytkownika w nagłówku From. wysłane 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 wątków i wiadomości

Etykiety istnieją tylko w wiadomościach. Jeśli pobierzesz listę etykiet wątku, otrzymasz listę etykiet, które znajdują się w dowolnej wiadomości w wątku. Etykieta może nie występować w każdej wiadomości w wątku.

Nie możesz stosować etykiet do wiadomości w wersji roboczej.

Dodawanie etykiet do wątków i usuwanie ich z wątków

Gdy dodasz lub usuniesz etykietę w wątku, zostanie ona dodana lub usunięta we wszystkich istniejących wiadomościach w tym wątku.

Jeśli po dodaniu etykiety do wątku zostaną dodane 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 w wiadomościach

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ść. 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 messages.modify.