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:
|
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.